alan-turing-institute / alan-turing-institute/deepsensor

💡 Suggestions for revisions of documentation

Open
#87 2 comments 1 reaction 0 assignees View on GitHub
Dominant language
Python
Stars
128
Forks
28
PR merge metrics
No merged PRs in 30d

Description

We're thrilled to now have new, extensive documentation for the DeepSensor package! This is a significant milestone in making our tool more accessible and user-friendly for everyone.

## What's New?

Our new documentation is designed to provide a comprehensive guide that includes:

- **Getting Started**: main concepts and how to install the package
- **User guide**: Overviews of the functionality of the package
- **Community**: A place where you can find ways to contribute to the package
- **API References**: detailed descriptions of the entire codebase, including all classes, methods, and functions

## We Need Your Input!

While we've put in a considerable amount of effort to ensure the documentation is as detailed and helpful as possible, we know there's always room for improvement. That's where you come in!

We are actively seeking feedback from our community to make our documentation even better.

## Here's how you can help:

1. **Read Through the Documentation**
Take a stroll through our new docs and see how they feel. Are they easy to understand? Is there something missing that you would have liked to see?
2. **Leave Your Comments**
We're opening this thread to collect all your comments and feedback. Don't hold back! Every piece of feedback is valuable, whether it's praise, criticism, or suggestions.
3. **Share Your Experience**
Did you find a particular section of the documentation especially helpful or confusing? Let us know your experience navigating through the information.

## Contribution Guidelines (Coming Soon!)
We are also in the process of implementing guidelines for how to contribute to the documentation. Stay tuned for updates on this front! (We'll drop a comment below when we have updates.)

## How to Comment

To leave a comment, simply reply to this GitHub issue. If you have suggestions for specific sections or pages, please include the link or a reference to that section/page in your comment.

## Thank You!

Your feedback is instrumental in helping us serve our community better. We appreciate your time and effort in helping us enhance the DeepSensor Python package documentation. Looking forward to hearing your thoughts!

Contributor guide

Open the contributing guide

Research direction

Read the new documentation through its Getting Started, User guide, Community, and API References sections. Record concrete, actionable feedback for any confusing or missing material, including a link or reference to the relevant page; no specific file or test is named, so completion is not otherwise defined.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.