Difference between revisions of "People come and go"
From CitconWiki
Jump to navigationJump to search (Created page with "== People come and go - information transfer == * Default way: documentation * Documentation doesn't: too long, outdated, not true, etc. * Generated documentation ** Test nam...") |
Adinnaplus (talk | contribs) (Added Useful video) |
||
| (One intermediate revision by one other user not shown) | |||
| Line 1: | Line 1: | ||
| + | =Notes= | ||
== People come and go - information transfer == | == People come and go - information transfer == | ||
| Line 10: | Line 11: | ||
** unit tests | ** unit tests | ||
** BDD acceptance tests | ** BDD acceptance tests | ||
| + | * Output of executable documentation | ||
| + | ** mostly plain text (TestDox, AgileDox) or HTML | ||
| + | ** in certain cases it's worth generating visualizations based on tests (e.g. state transition diagrams) | ||
* Video documentation: screencasts for bug reports | * Video documentation: screencasts for bug reports | ||
* Searchable documentation | * Searchable documentation | ||
| Line 24: | Line 28: | ||
* The book "Specification by example" was referenced http://specificationbyexample.com/ | * The book "Specification by example" was referenced http://specificationbyexample.com/ | ||
| + | |||
| + | =Useful videos= | ||
| + | Alan Richardson - Thinking Visually in Software Testing | ||
Latest revision as of 13:09, 12 November 2012
Notes
People come and go - information transfer
- Default way: documentation
- Documentation doesn't: too long, outdated, not true, etc.
- Generated documentation
- Test names
- Javadoc
- meta documentation: directory structure, etc.
- Executable documentation
- unit tests
- BDD acceptance tests
- Output of executable documentation
- mostly plain text (TestDox, AgileDox) or HTML
- in certain cases it's worth generating visualizations based on tests (e.g. state transition diagrams)
- Video documentation: screencasts for bug reports
- Searchable documentation
- Substitutes of documentation: face time, talk, e.g. before a new feature is being developed
- Documentation is not the goal. The goal is that the other person understands something
- Documentation needs to be searchable
- generated documentation too
- executable documentation too
- Put documentation to the right place:
- (links to) trouble-shooting tips to system monitor items
- docs should go to the same repo as code goes
- The book "Specification by example" was referenced http://specificationbyexample.com/
Useful videos
Alan Richardson - Thinking Visually in Software Testing
