Skip to content

Conversation

@theodorejb
Copy link
Contributor

@theodorejb theodorejb commented Oct 19, 2025

Adds a release.inc file for PHP 8.0 like the other release pages have, in order to avoid duplicating all the markup for every translation (making it much easier to maintain consistent content). Apart from the following exceptions, no content or translations have been changed:

Consistency improvements

  • Added IDs to headings in section above footer for direct linking (like the other release pages have).
  • Added <code> tag around operators and keywords for better readability (the other release pages do this).
  • Updated code examples to consistently use 4-space indentation (previously the attributes code example used four spaces and others used two spaces).

Translation-specific fixes

  • Fixed bug where heading links in the French and Japanese translations unexpectedly switched to the English translation of the page (caused by incorrect $_SERVER['BASE_PAGE'] value).
  • Spanish, Italian, and Turkish pages previously incorrectly linked to English documentation for some or all of the documentation links.
  • French translation previously had a different code example for attributes, which didn't really make sense (it showed the same /api/posts/{id} Route attribute, but above a User class rather than on a get method in a PostsController class).
  • Fixed incorrect Static Return Type RFC link in Portuguese translation.
  • Fixed a couple minor spacing bugs in Spanish translation.
  • Chinese page previously was missing translation for Documentation link in a couple places.
  • Fixed missing blank lines in a few Chinese translation code blocks.
  • Fixed inconsistent strings in Georgian match expression example.

In a second commit, I also fixed broken documentation links on the PHP 8.1 Georgian translation.

@sy-records
Copy link
Member

Thank you for your contribution, but I don't think it's necessary to modify the 8.0 version.

We're currently pushing forward with the new design for 8.5.

@theodorejb
Copy link
Contributor Author

My goal wasn't to modify it, but to structure it the same as the other release pages for ease of maintainability. As part of this I found a bunch of bugs and inconsistencies which could be fixed at the same time.

@theodorejb theodorejb force-pushed the simplify-8.0-translations branch 2 times, most recently from b6b11d4 to 5b70726 Compare November 3, 2025 04:17
@theodorejb
Copy link
Contributor Author

Does anything prevent merging this? The only content change now is adding <code> tags around operators and keywords for better readability like the other release pages have. Numerous bugs have been fixed and this greatly simplifies maintainability of the page.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

🚀 Preview for commit b0c6afa can be found at https://web-php-pr-1530.preview.thephp.foundation

@github-actions
Copy link
Contributor

github-actions bot commented Nov 3, 2025

🚀 Regression report for commit b0c6afa is at https://web-php-regression-report-pr-1530.preview.thephp.foundation

@sy-records
Copy link
Member

We need to update the screenshots in testing. Perhaps @saundefined can assist.

Adds a `release.inc` file for PHP 8.0 like the other release pages have, in order to avoid duplicating all the markup for every translation (making it much easier to maintain consistent content). Apart from the following exceptions, no content or translations have been changed:

Consistency improvements:

* Added IDs to headings in section above footer for direct linking (like the other release pages have).
* Added `<code>` tag around operators and keywords for better readability (the other release pages do this).
* Updated code examples to consistently use 4-space indentation (previously the attributes code example used four spaces and others used two spaces).

Translation-specific fixes:

* Fixed bug where heading links in the French and Japanese translations unexpectedly switched to the English translation of the page (caused by incorrect `$_SERVER['BASE_PAGE']` value).
* Spanish, Italian, and Turkish pages previously incorrectly linked to English documentation for some or all of the documentation links.
* French translation previously had a different code example for attributes, which didn't really make sense (it showed the same `/api/posts/{id}` Route attribute, but above a User class rather than on a `get` method in a PostsController class).
* Fixed incorrect Static Return Type RFC link in Portuguese translation.
* Fixed a couple minor spacing bugs in Spanish translation.
* Chinese page previously was missing translation for Documentation link in a couple places.
* Fixed missing blank lines in a few Chinese translation code blocks.
* Fixed inconsistent strings in Georgian match expression example.
@theodorejb theodorejb force-pushed the simplify-8.0-translations branch from 5b70726 to eccf9f9 Compare November 3, 2025 23:44
@theodorejb
Copy link
Contributor Author

@sy-records I updated the screenshot now.

@sy-records sy-records merged commit 30c04c6 into php:master Nov 7, 2025
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants