Talk comments

Anonymous at 18:33 on 2 Jun 2017

This talk was smooth. Well-paced, decent slides, voice wasn't too quiet (but could have been louder in that echo-y hall).

Tim Hofman at 22:44 on 1 Jun 2017

I liked the structure of the presentation. First a few examples what the possibilities are, explain why the most of these methods are not optimal and eventually share the better ways to document your code.
It was good to hear my colleagues and I are documenting our code in a good way. It's always nice to get confirmation.

If you ever come across a script which can automatically built a documentation website based on code in a version-controlled repository, let me know!

Anonymous at 14:31 on 31 May 2017

Excellent talk, well presented. Didn't agree with everything, but all the better: it's great to hear a well-presented point that conflicts with your own views.

The main thing that could perfect this presentation would IMHO be to explain somewhere in the first part of the presentation what *kind* of documentation you're talking about and/or what your definition would be. E.g. some things that weren't (entirely or timely) clear to me:

- Is user documentation (e.g. manuals) included?
- Is mandatory documentation (e.g. required by law) included?
- Are we just talking about docs for public APIs / endpoints / touch points, or also inline comments?

Three other final random points I missed:

- Is there a difference between Line-of-Business applications and APIs or Frameworks?
- Does the (intended) audience of the docs matter?
- I also would've loved to have seen a quick toy project with what would be considered "perfect", documentation wise.

But again, all in all: good talk!