"I didn't have time to write a short doc, so here's a long one"
However, if I want to distill it to a smaller doc, I'd need to spend another day to make it perfect, and I don't have time, unfortunately.
I wasn't mocking op, I was referencing Mark Twain
Who knows, maybe longer docs reduce misunderstanding, like how error correction reduces problems as the information moves through mediums. :)
I go by Feynman's logic: if you can't explain it simply you don't understand it. Redundancy doesn't seem to me to be a good thing in documentation. Would make it harder to parse and maintain...
Ah, that happens, no problems on my side whatsoever.
> I go by Feynman's logic: if you can't explain it simply you don't understand it.
That's true, but in reality it needs a couple of passes to distill down, which needs time. An example of a live document I have written can be given as [0].
Can it be better? By miles. How much time does it need? An amount I don't have right now. "When you're poor, everything is expensive" works for time, too. So, I try to do my best when I have time, and polish it later when I have additional time for it.
[0]: https://notes.bayindirh.io/notes/Hardware/Installing+a+Home+...
And increases the word count, making it less likely someone will even begin reading it.
This way your document will look compact and neat while having all the necessary information contained in everywhere and every part of your documentation.
Also interconnected documents reduce the burden of repeatedly updating duplicate parts. You reference or link it, and update and change it for once.
Note: Yes, I have intentionally and knowingly written that way.
> In conclusion, Blaise Pascal wrote a version of this saying in French and it quickly moved into the English language. The notion was very popular and variants of the expression have been employed by other notable figures in history. The saying has also been assigned to some prominent individuals without adequate factual support.