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

Upgrades to documentation #6

Open
10 tasks
joewheaton opened this issue Feb 11, 2021 · 2 comments
Open
10 tasks

Upgrades to documentation #6

joewheaton opened this issue Feb 11, 2021 · 2 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@joewheaton
Copy link
Contributor

Please update your documentation for Riverscapes Compliance as per here. I can see you and @wally-mac put a ton of effort into this. It is nice. Lets get it at least to riverscape compliance pending.

Things I noticed:

  • Release and version missing
  • No download of tool
  • No link to source code or repo
  • There is limited high-level "this is what the tool does". Front page is nice, but amigouous.
    Missing following from site content recommendations
  • Release Notes
  • Acknowledgements should be on separate page
  • Source Code
  • Citations
  • Prerequisites

On your documentation, I am really NOT a fan of linear wizard driven tools and documentation (i.e. Step 1, Step 2). That makes sense for a tutorial, but seems hard for tools. I would at least:

  • Provide a name in title for each step (e.g. instead of Step 1 use Step 1 - Project Housekeeping)
@joewheaton joewheaton added the documentation Improvements or additions to documentation label Feb 11, 2021
@tyler1218hatch
Copy link
Contributor

@joewheaton I'll look into this soon. PNET is a tool that was really developed for a singular project. I'm happy to spend some time improving it and making it more flexible, as well as getting it Riverscapes Compliant.

@joewheaton
Copy link
Contributor Author

joewheaton commented Feb 12, 2021 via email

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

No branches or pull requests

2 participants