2019 01 21 Open NEST Developer Video Conference - nest/nest-simulator GitHub Wiki

previous | list | next

Agenda

1. Welcome

2. Info/Discussion on git commit messages (speaker @clinssen)

   • some commit messages only make sense in the context of current development in the specific branch, but is mostly useless after merge

   • blame based on commits

   • distinguish between what changed (diff) and why it changed (← commit messages!!)

   • has to be part of code review

   • do not bundle many different changes in the same commit

   • 6 1/2 rules for messages

     0. correct name and mail address
     1. atomic commits: separate commits for logically separate changes
     2. "if applied, this commit will…" {commit message}
     3. be descriptive: why (explain), how (justify), what (effects)
     4. be concise (single line <50 <70 chars (git limit))
     5. cross-reference where possible
     6. have consistent style, capital letter?, full stop?, …

3. Review of NEST User Mailing List

   • little activity

4. Review of open Github Pull Request

   • PRs checked
   • updates on projects

5. Review of open Github Issues