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:

Content and layout 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.
  • Moved Just-In-Time Compilation section to a half-width column rather than full-width. This is more consistent with the other release pages, and makes it easier to read the description on large screens since the paragraph isn't so excessively wide.
  • Updated code examples to use 4-space indentation rather than 2-space, for consistency with all the other release pages.
  • Updated the "New Classes, Interfaces, and Functions" section to show the actual class name for WeakMap and PhpToken (which removed the need for translation there).
  • Moved both RFC links after the text for "Allow a trailing comma in parameter lists and closure use lists" for simplicity and consistency across translations.

Translation-specific fixes and changes

  • Fixed bug where header 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.
  • Georgian translation previously changed strings/comments in the code examples for Union Types and Match Expression. If this is still wanted we could add translation strings to include in these code blocks, but I don't think it's worth it since the examples already have translated descriptions, and these code blocks weren't altered for any other languages.

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:

Content and layout improvements:

* Added IDs to headings in section above footer for direct linking.
* Added `<code>` tag around operators and keywords for better readability.
* Moved Just-In-Time Compilation section to a half-width column rather than full-width. This is more consistent with the other release pages, and makes it easier to read the description on large screens since the paragraph isn't so excessively wide.
* Updated code examples to use 4-space indentation rather than 2-space, for consistency with all the other release pages.
* Updated the "New Classes, Interfaces, and Functions" section to show the actual class name for `WeakMap` and `PhpToken` (which removed the need for translation there).
* Moved both RFC links after the text for "Allow a trailing comma in parameter lists and closure use lists" for simplicity and consistency across translations.

Translation-specific fixes and changes:

* Fixed bug where header 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.
* Georgian translation previously changed strings/comments in the code examples for Union Types and Match Expression. If this is still wanted we could add translation strings to include in these code blocks, but I don't think it's worth it since the examples already have translated descriptions, and these code blocks weren't altered for any other languages.
@theodorejb theodorejb force-pushed the simplify-8.0-translations branch from bb8969f to 7804a3d Compare October 19, 2025 21:03
@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.

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