Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release 1.0 Documentation #126

Open
wants to merge 8 commits into
base: release/1.0
Choose a base branch
from
Open

Release 1.0 Documentation #126

wants to merge 8 commits into from

Conversation

kels271828
Copy link
Member

Things we need to work on:

  1. Comment on the structure before we start filling in content.
  2. Main index.rst page needs a description
  3. Section index.rst pages need descriptions
  4. Individual pages need content added (or relevant docstrings updated)

One idea is that we can branch off of feature/docs to fill in content, then create PR's to feature/docs. Once we are happy with the documentation, we can merge this PR. People can comment on this PR with what sections and/or pages they want to write.

@kels271828 kels271828 marked this pull request as ready for review December 31, 2024 20:37
@kels271828
Copy link
Member Author

We can also define some style conventions (e.g., Do we use Onemod, OneMod, etc. when referring to the package? What types of headings do we use?). This can be defined by whoever works on the developer guide contributing docs page.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hahahaha

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lol, I found the logo here (https://healthicons.org/), was hoping for something more relevant but ended up with this bkah!

Copy link
Member

@zhengp0 zhengp0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks very much @kels271828!

@blsmxiu47
Copy link

We can also define some style conventions (e.g., Do we use Onemod, OneMod, etc. when referring to the package? What types of headings do we use?). This can be defined by whoever works on the developer guide contributing docs page.

I like the idea of having style conventions. We could store them in the Contributing to Docs section of the Developer Guide. Personally I don't have strong style preferences though. Whatever is fine, as long as we are consistent.

@blsmxiu47
Copy link

To start I can work on the Developer Guide section (but anyone should feel free to propose style conventions), probably some parts of Advanced Usage, like DataInterface and Validation (if validation is a feature we intend to build out), and then will see what others haven't claimed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants