OrchardCMS / OrchardDoc

Documentation for Orchard 1.x (not Orchard Core, for that see https://docs.orchardcore.net/).
http://docs.orchardproject.net
142 stars 242 forks source link

Document contribution guidelines aren't consistent #340

Open robertwray opened 6 years ago

robertwray commented 6 years ago

There are two places within the repository where documentation contribution guidelines are covered:

The content in .md is the more comprehensive of the two, with the .markdown file containing an instruction to add a "targets and tested against version X" top-hat to documentation pages and nothing more. The dissonance between these two documents (as it's not even a case that one is a subset/superset of the other) should be resolved.

robertwray commented 6 years ago

Proposals/Options:

  1. Add the "version top-hat" note to contributing.md and then replace the content of Contributing-documentation.markdown with that of contributing.md
  2. Add the "version top-hat" note to contributing.md and then replace the content of Contributing-documentation.markdown with a reference & link to contributing.md

My preference is for option 2 as this will avoid having duplicated content which can get out of synch, having someone who wants to read the doc contribution guidelines have to click through to a file on GitHub is not onerous.