On 06.09.2024 at 16:38, Remi Collet wrote: > Hi, > > Le 04/09/2024 à 15:04, Christoph M. Becker a écrit : >> Hi all, >> >> that issue came up the other day on a pull request[1], but since it is >> not particularly related to any single PR, I wanted to ask here for >> clarification. >> >> This is about changes to `./configure` options of php-src, and whether >> these should be documented in UPGRADING or UPGRADING.INTERNALS. For the >> master branch, most such changes are currently documented in >> UPGRADING.INTERNALS, but a few are in UPGRADING. > > There is various targets > > UPGRADING is for PHP users > so only changes in the languages > > UPGRADING.INTERNALS is for others > - linux builders > - windows builders > - php developers > > So, I'm fine with current content. > > Perhaps we could split changes about build in > separate files.
Given that the most relevant place to document such changes is apparently controversial, this might be a good idea. Actually, I'm fine with either solution, but I consider it *very* important that *all* build related changes are in one place. Nobody should be required to scan multiple documents to get this information. And that is also important for the docs team, since they are supposed to integrate this information into the PHP manual (first to the migration guides, and then to the manual proper). Christoph
