[00:01:15] Sam and Natalia give us a little background of themselves.

[00:03:21] There a lot of different kinds of documentation, so a few of the panelists tell us how they were drawn to write documentation and why it’s so important.

[00:18:03] We will talk about things that the panelists don’t like about documentation. So, we learn some mistakes they’ve made and regretted, and things they used to do that they’ve since learned this is a much better doing it this other way. Some great advice is given here. ☺

[00:28:14] Ari and Tessa tell us some of their pet peeves when it comes to encountering documentation.

[00:32:38] Sam talks about style guides being useful in documentation. Natalia tells us her favorite rules from their internal style guide.

[00:39:35] Ari tells us what of her greatest pet peeves when Chris talks about use cases, and then asks him how you land on the right amount of detail in a use case example.

[00:47:32] Tessa wants to know how to keep docs up to date, how to manage the really simple specific idea, and how to guide people between that liminal space.

[00:52:48] Speaking of automation, Chris tells us something he’s done in a pre-commit hook for project documentation and Natalia and Ben have something to add as well.

[00:56:50 ] Tessa asks what are some good practical tips that she can apply to a document more effectively and be advocate for documentation in a company. Great advice is given here by the panelists. ☺

[01:07:41] Natalia and Sam tell us where you can find them on the internet. Also, if you’re looking for a job as a technical writer, Sam gives a plug for their good friend who has a technical writing consulting business, called Good Words (link below).

Picks of the week:

Sponsor:

Resources mentioned:

Special Guests: Natalia Tepluhina and Sam Brandt.

Support Enjoy the Vue