biocompute-objects / BCO_Documentation

Repository for documentation to support the IEEE 2791-2020 standard. Please see our home page for communications/publications:
http://biocomputeobject.org/
BSD 3-Clause "New" or "Revised" License
16 stars 12 forks source link

Wiki #80

Closed HadleyKing closed 4 years ago

HadleyKing commented 5 years ago

Should we implement the use of Git Wikis for V2.0? Are there any downsides?

corburn commented 5 years ago

No, wikis tend to be filled with documentation and are a mess to maintain. When documentation is kept in the repository it is current for the revision that is checked out. When documentation is kept in a wiki, decoupled from the repository, it is current for whenever the segment was last updated. Github Wikis are not easily searched. For anything that is not documentation, Github Issues are at least searchable, revisable, and referable.