Thanks for the info, @kevinhaig
As for “incorporate the docs as they were at the time of 4.9”, this should be possible to do with the WP scraper if we simply run it over a 4.9 (or better: ClassicPress) install.
What is trickier is the user notes, not sure how to get those.
I personally don’t care what tool we use. What cannot be is that due to “opinions”, we end up not having a doc.
And there is not much to opinate here actually. The Code Doc Blocks are there, and it is silly to not use them, thus, human written doc is not the way to go. This is just a fact. Also fact is, that converting a “WP/CP” post doc to Github is again a silly, unnecessary additional step.
If we simply take the formula for perfection, which is “As long you can take away something without breaking the functionality, it is not perfect”, we can exclude opinions and discussions.
The minimal, working version of such DOC is to let a machine scan the code and build doc from the Code Doc Blocks.
Everything else added to that, is not making it more perfect, but more bloated (and perhaps fancier).
I totally understand your frustration and understand your reasoning. I would prefer to not use a “wheel re-invented” solution, but on the other hand, if your system is able to do all what you described, I am interested in using it.
The main question here is, if you would be able, and willing to, share the source so I can build this for CP finally.
If you are, would you mind to share this with me?
I am a self thought dev as well, and I will not belittle you because of possible coding approaches because I did not forget where I started. I did not forget that I knew nothing about code a few years ago, and still know nothing, this is just my live style. You never learn out.
What is “bad code” can be rewritten and there is nothing bad with that. The credit goes to you as the initiator and the one with the will and persistence to actually create it rather than fuss around with opinions and discussions. Don’t misunderstand me, I am aware that a democracy lives on opinions and discussions, but if people die because the society is not agreeing on how to perform a surgery or respond to a cataclysm, we can as well go back into caves. Without going into politics, this is IMO one of the main reasons why democracy is not the final solution - votes can be influenced, lobbied and in the end, it is just a ochlocracy. Specially when we vote but do not have constructive contributions to make. I am from a country that heavily suffers under this effect and ended up putting up laws that directly oppose Human rights just because “the majority voted yes”.
So, enough of this off-topic reasoning.
I don’t think there is much to discuss. The requirements are clear, we need a DOC. And it needs to be easy to maintain, and not go over 5 edges to achieve the goal we can achieve with one edge.
Thus, It is perfectly OK to have a GitHub stored user documentation with How To’s and the like, but for Code DOC, we will plain simple need a (plain simple) CP Install where we can manage these code docs
I am not sure if I miss something here but it shouldn’t take too much work to actually create such install, put it in a subdomain of CP, and Link to it. The current doc.cp.net (user doc) can still proceed existing. We can create a codex.cp.com or developer.cp.com for the code-doc