Oh I'm not planning to make a documentation FOR makedocs - my concern is, that in the 2000 lines worth of makedocs code, there are only 42 actual comments (and 14 of them were added by.....: me). Not much less unmaintainable I probably could try to change that (post comment Marks code), but since I wanted to add and/or fix some bits, I felt saver to go on my own journey. I hope that is comprehensible...it is a great idea to get a big part of the docs by just 'commenting" your code. The problem is, that good documentation inside the code is making the code unmaintainable.
Mmmh, I tend to disagree. For my fantom frameworks, I went down this route. Commented everything inside the source code and having a selfmade tool spill out .cerberusdoc files. These frameworks are not small and I think they are maintainable.The problem is, that good documentation inside the code is making the code unmaintainable.