Thanks for that post, Eli! I am not sure if I have ever seen someone being that succinct and articulate about the art of documentation writing. It did answer a lot of things that my brain was struggling to put clearly.
Especially the "The Why. The What and the How" section. I seldom get this feeling where it feels like I knew this but didn't know how to say it. This was definitely one of those moments.
I will make sure to keep you updated with the documentation project (although officially I have not started yet).
Once again, thanks for all the encouragement and advice. It really helps.
P.S: Psst....I am a fan of the FreeBSD handbook as well. :)
I'm glad it helped :) I didn't expect it to be such a popular topic; I'm glad you brought it up for discussion! It's been so cool seeing different people's perspectives on it.
We're a place where coders share, stay up-to-date and grow their careers.
We strive for transparency and don't collect excess data.