Superb talk! Simple yet effective tips, ideas, & approaches to making documenting your code a lot easier. A MUST watch if you want to become more consistent with writing GOOD documentation.
Thanks Thursday, as a fellow documenter (and coder) I can't agree with you enough as to how important documentation is, especially when working with non-technical stakeholders.
Always good to learn about documentation.
Would like to see more information on the slides though. As I missed one (or several) words, I was not able to get up to speed by looking at the slide.
A lot of good points in this talk. My only concern is how slowly Thursday spoke, however she was very clear and concise! I look forward to attending more talks from her.
Great talk on the importance of documentation with lots of handy tips thrown in. Especially loved the one about making writing documentation a habit - even if you'd only produce bad documentation on some days, it's still better than no documentation.
Very good talk. Thank you. The audio seemed to be auto-adjusting quite a lot so there would be a few seconds where it sounded great and then followed by a few more seconds where it sounded like it was in an airport when planes were taking off.
I liked the minimalistic slides, it kept you focused on what Thursday was saying.
What this talk could do with was a bit less surfacing goodness on how important it is to write documentation and a little bit more examples of different kinds of documentation and what inter-human purpose they serve, as well as documentation (text writing) styles that work and don't work for programmers.
Loved the tip of doing documentation daily and getting better over time. No brainer, but hadn't thought of it. Perhaps cover intro a bit less. Everyone knows it is important, but how to build habits needed more time.
Excellent talk! The speaker was very clear and concise, and provided some great tips on how to get over "documentation dread" by making it part of your everyday routine. I would have liked to hear more on the types of documentation and their respective audiences, as well as more tips/guidance on what makes documentation "good".
Comments
Comments are closed.
Superb talk! Simple yet effective tips, ideas, & approaches to making documenting your code a lot easier. A MUST watch if you want to become more consistent with writing GOOD documentation.
Thanks Thursday, as a fellow documenter (and coder) I can't agree with you enough as to how important documentation is, especially when working with non-technical stakeholders.
Always good to learn about documentation.
Would like to see more information on the slides though. As I missed one (or several) words, I was not able to get up to speed by looking at the slide.
A lot of good points in this talk. My only concern is how slowly Thursday spoke, however she was very clear and concise! I look forward to attending more talks from her.
Great talk on the importance of documentation with lots of handy tips thrown in. Especially loved the one about making writing documentation a habit - even if you'd only produce bad documentation on some days, it's still better than no documentation.
Very good talk. Thank you. The audio seemed to be auto-adjusting quite a lot so there would be a few seconds where it sounded great and then followed by a few more seconds where it sounded like it was in an airport when planes were taking off.
I liked the minimalistic slides, it kept you focused on what Thursday was saying.
What this talk could do with was a bit less surfacing goodness on how important it is to write documentation and a little bit more examples of different kinds of documentation and what inter-human purpose they serve, as well as documentation (text writing) styles that work and don't work for programmers.
Great talk. There is a lot I need to work on.
Slight issue with the audio going up and down.
Loved the tip of doing documentation daily and getting better over time. No brainer, but hadn't thought of it. Perhaps cover intro a bit less. Everyone knows it is important, but how to build habits needed more time.
Excellent talk! The speaker was very clear and concise, and provided some great tips on how to get over "documentation dread" by making it part of your everyday routine. I would have liked to hear more on the types of documentation and their respective audiences, as well as more tips/guidance on what makes documentation "good".