Skip to content

Upgrades to documentation #6

@joewheaton

Description

@joewheaton

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)

Metadata

Metadata

Labels

documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions