Documentation is harder than coding.
Shared understanding is harder than documentation
Indeed
Not only writing documentations, but also searching and reading a lot of them, and being able to join the dots and don't waste time building from scratch something that has already been built or that can be evolved over an existing product/service/platform.
Working for people is harder than working for computers
Diego Giacomelli Cardoso, MSc. Do you agree ?
said no one ever
Totally! And if you allow me a comment: my impression is it is so worth it to have a dedicated documenter with the right skills for the job. For example, after working with Russell Bohl in many teams here at Liferay, the results are spectacular. I often caught myself reading the docs to understand what I did months ago. ?? On another note: do you know Python's doctests? If no, I suspect you'd like to check the concept! It really brings joy to developers when documenting (at least to me ??).
Empowering developers with zero-trust architectures and open-source innovation
3 年So true, code can consistently produce the same results. Documentation will produce wildly different results based on who is using it.