swcarpentry / managing-research-software-projects

Managing small to medium-sized research software projects.
https://swcarpentry.github.io/managing-research-software-projects/
Other
37 stars 13 forks source link

Basics == version control? #48

Closed standage closed 7 years ago

standage commented 7 years ago

When I ran a 90-minute version of this material at LBL, I followed up the intro materials with a discussion of Noble's rules and Taschuk's rules. As important as version control is (I went as far as to argue that it's a professional obligation), I wouldn't necessarily claim it to be as "basic" as things like project organization and software robustness.

I suggest we bring back Noble's rules, and move the "software robustness" discussion up as well. I think this, along with perhaps the hosting/issues/license stuff, forms the core of what I would call "the basics".

I'd be happy to submit a PR for this, but before I do so I'd be interested in everyone's thoughts / reactions (especially @gvwilson).

standage commented 7 years ago

As important as version control is (I went as far as to argue that it's a professional obligation), I wouldn't necessarily claim it to be as "basic" as things like project organization and software robustness.

I take this back. For this material, version control is basic and should be included in the front matter. This seemed to work well for my Sept 2017 LBL workshop. I still think we benefitted from bringing project organization (Noble) and robustness (Taschuk) to the front, though.