Re: Moving `php-src/docs` forward

On Aug 21, 2026, at 4:29 PM, Weilin Du <weilin-du@qq.com> wrote: > > 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. Very much this. We have a ton of stale docs on i.e. the wiki, internals book, etc. There was the effort to write more in docs/ (plus archiving the old stuff in docs-old/). Changing the format is minor, rST I don't think will pose a difficulty to people writing it more than Markdown in the same place.