swcarpentry / good-enough-practices-in-scientific-computing

Minimalist alternatives to "best practices" paper
https://swcarpentry.github.io/good-enough-practices-in-scientific-computing/
Other
158 stars 23 forks source link

Organization, particularly Discussion sections, is inconsistent #114

Closed beroe closed 8 years ago

beroe commented 8 years ago

Some sections have Discussion subheadings and some don't and it is not totally clear why. Also in Version Control the Discussion section does not come last, but is followed by the When is VC not Necessary section. For scanning through a multi-page document, having multiple Discussion sections could be confusing.