hydrotools
hydrotools copied to clipboard
NOAA-OWP
Automate gh-pages deployment evalution_tools version tracking
As shown, right now the version number requires manual updating. I need to explore how to improve this.
Tangentially, I think we could improve version bumping for this package and the sub-packages included. I know that bumb2version is commonly used, but I think it makes sense to do some research to find the best option.
@aaraney kicking this dead horse to talk about docs!
From a maintenance and ease of use perspective, I would love to switch from sphinx to mkdocs/mkdocstrings. From what I've experienced the mkdocstrings plugin works best with Google style docstrings. The numpy docstrings we use will work, but aren't fully supported by mkdocstrings and tend to get a bit jumbled.
I don't mind doing a review of our documentation and converting everything to Google style. However, I thought I would give you a chance to weigh-in before doing that. I'd also use this opportunity to review all our docs and fill them out where needed (like adding Example sections).
The advantage of all this is that we can use our existing README.mds as landing pages for each subpackage and I think adding new docs and deploying to gh-pages will be much simpler and streamlined.
@aaraney kicking this dead horse to talk about docs!
From a maintenance and ease of use perspective, I would love to switch from sphinx to mkdocs/mkdocstrings.
Likewise! I really like mkdocs and find it much easier to use too.
I don't mind doing a review of our documentation and converting everything to Google style. However, I thought I would give you a chance to weigh-in before doing that. I'd also use this opportunity to review all our docs and fill them out where needed (like adding Example sections).
That sounds like a fair amount of work to ask of one person. I'm happy to help out if you okay with splitting out the workload?
That sounds like a fair amount of work to ask of one person. I'm happy to help out if you okay with splitting out the workload?
Well, it doesn't have to be done tomorrow. Assume I initiate changes in a piecemeal fashion and ask for your review via the PR system. That way at least two sets of eyes see all the docs. Sound good?