4 ms·
Few notes: - I do tend to document much BUT not to publish my personal docs to the world, so well, I'm not selling much for free; - while I tend to document I
by kkfx 3y ago
Few notes:
- I do tend to document much BUT not to publish my personal docs to the world, so well, I'm not selling much for free;
- while I tend to document I find a curious issues, maybe mine, maybe common: on one side I fail to proper document anything: I start baldly to document something but quickly decline and fail completing the docs, integrate it with the others and properly keep anything up to date, conversely while I have even too much text written on various stuff I fail to have something like a simple "my home siteguide for my family", subtitle: "If/when incapacitated my dear you can find here all infos too keep the home up and running";
- for literate programming personal stuff it's the same: I tend to start in org-mode with much prose and an outline of anything, but many times I end up abandoning the literate approach to write code directly that a certain point in time I go back splitting the now working and complete enough code in the original org-mode structure, who generally get revised a bit. Than a plateau until something break and the game restart.
Long story short:
- documenting does not means showing anything to anyone on a personal website, it can perfectly be just for few people in private;
- documenting and keeping thin up to date probably demand a not so common discipline and maybe that's why in most places there are a more or less big pile of document crap and little usable, up to date and easy to use documentation.