Re: [PHP-DEV] Moving `php-src/docs` forward

On Aug 21, 2026, at 4:29 PM, Weilin Du <[email protected]> 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.