Hi Nick,
I don't object to the change, nor in favor of it. However, since you've posted under the topic "Moving php‑src/docs forward", I want to send you this email. I want to quote something here: “the single worst strategic mistake that any software company can make: They decided to rewrite the code from scratch” Now, if the goal is to move the document forward, I don't see why we are rewriting it from rst to md. I don't want to debate about whether rst if better or md is, I would say that, famous doc hosters like readthedocs are rst users. If you want to convince other that md is better than rst, in my honest opinion your proposal is impossible to pass. To some extend, the statement is similar to those crazy rust folks. The point isn't rst is better, the point is if there are indeed benefits, is the benefits worth the effort and time to put in, and worth to risk the break that potentially exists? Note that you are basically adding new requirements here to make your md file works. In other words, if you and reviewers put the same effort into the content itself, would it be more effective to the topic "Moving php‑src/docs forward" than rewriting it in different language? See? I say I don't object to the change because I don't think I have a say on internal doc, but I hope you can focus on the content itself instead of this if you want to make the internal doc better. That is, update missing APIs through UPGRAING.INTERNALS, building new chapters, writing articles for newcomers, etc, etc. That sounds way more better to me, and I am glad to see these contributions happening Cheers, Weilin D.
