Skip to content

Third-party manual, doc-base side - #324

Merged
alfsb merged 6 commits into
php:masterfrom
alfsb:third-party-ext
Jul 31, 2026
Merged

Third-party manual, doc-base side#324
alfsb merged 6 commits into
php:masterfrom
alfsb:third-party-ext

Conversation

@alfsb

@alfsb alfsb commented Jul 21, 2026

Copy link
Copy Markdown
Member

This is the doc-base side of php/doc-en#5682 , for the splitting of third-party manuals from the main manual, with the minimal conventions possible. I took the path of also minimizing any XML output differences. In fact, the only output change occurs in the DOCTYPE node, the XML is identical. Also, the code is already prepared for any disappearance of actual DTD entity files.

As this is a big change, I plan to leave this open for almost two weeks.

The planned merge order is doc-en 5682 on July 30, and this in July 31. In the meantime, preparing for the actual disappearance of DTD entity files.

@alfsb

alfsb commented Jul 21, 2026

Copy link
Copy Markdown
Member Author

Comments and reviews wellcome.

Build breakage is expected, as manual.xml still does not exist on doc-en.

Comment thread configure.php Outdated
@alfsb alfsb mentioned this pull request Jul 21, 2026
47 tasks
@alfsb

alfsb commented Jul 30, 2026

Copy link
Copy Markdown
Member Author

Tomorrow is the big day. With this PR, doc-base becores almost independent of main manual manual.xml, so extension and external manual also becomes independent. Some last comments, before the big push merge?

@alfsb
alfsb merged commit 127eb6a into php:master Jul 31, 2026
12 checks passed
@alfsb
alfsb deleted the third-party-ext branch July 31, 2026 12:51
@alfsb

alfsb commented Jul 31, 2026

Copy link
Copy Markdown
Member Author

Merged. No differences detected on XML body so far. I will do some more tests, on all languages, to be sure. Next in line, DOCTYPE minimization, XML trim and possibly adding a warning on GH CI builds about invalid results.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants