3 ms·
A separate specification works much better as long as that specification is also enforced during the build. A separate openapi spec that is not enforced can qu
by dtech 7y ago
A separate specification works much better as long as that specification is also enforced during the build.
A separate openapi spec that is not enforced can quickly become outdated, then an auto-generated from code is better.
- undreren 7y agoYou can add two new columns to your Kanban board called "Documentation" and "Documentation Review". Then tasks cannot move to your "Done" column unless documentation is written and passes review. If you enforce column limits documentation it will also block other tasks if not completed.
- Waterluvian 7y agoIn addition to this (and going a bit off topic). I've been adding checklists to Github PR templates (it's really easy[1]) for things like, "Did you re-read the relevant API docs? Do they need to be changed?" and it helps me a ton. [1] https://help.github.com/en/articles/creating-a-pull-request-template-for-your-repository https://help.github.com/en/articles/creating-a-pull-request-...
- undreren 7y agoChecklists work so well. A kanban board has all the same qualities if used correctly :)
- dtech 7y agoI have about as much confidence that is gonna work as I'd have in a (non-automated) "Test" and "Test review" column
- undreren 7y agoCool.