Now what, Tech Lead?

Now what, Tech Lead?

Write the Docs 2022

Bonus edition with insights from the most recent Write the Docs conference

Thiago Carvalho's avatar
Thiago Carvalho
Sep 30, 2022
∙ Paid

Ahoj!

While the October edition of this newsletter is still in the oven (spoiler: it is about Developer Productivity), Here are some insights from the most recent Write the Docs conference.

According to the 2021 edition of the state of JS survey, documentation is the #1 answer to "Which factors do you prioritize when evaluating a new library?". 

This question is about adding an external library to your project, but what is the implication of this question to your internal tools? Especially if you have many microservices. What is the cost (onboarding time, lost productivity, pain and suffering) of an internal tool with poor documentation?

Source via Emilia Juda-Özbay's talk 

Want to dive deeper into the topic? Emilia shared some interesting papers:

  • Software documentation: the practitioners' perspective

  • The Types, Roles, and Practices of Documentation in Data Analytics Open Source Software Libraries

Need to convince your boss to invest in technical documentation? 

This post is for paid subscribers

Already a paid subscriber? Sign in
© 2025 TCDS Desenvolvimento de Software LTDA · Privacy ∙ Terms ∙ Collection notice
Start your SubstackGet the app
Substack is the home for great culture