[web-php] PR #989: Revert "Enable Polish translation again", for now
| From: | Sobak | Date: | Thu, 09 May 2024 16:19:35 +0000 |
| Subject: | [web-php] PR #989: Revert "Enable Polish translation again", for now | ||
| Groups: | php.webmaster | ||
| Request: | Send a blank email to php-webmaster+get-31659@lists.php.net to get a copy of this message | ||
Pull Request: https://github.com/php/web-php/pull/989
Author: Sobak
This reverts commit 70bd5e0aa9134022e3c2269a7c72dbb3b1ab0fdd.
While the docs do build, I belive there's at least a few specific action points we should
tackle before we open them up to the world.
I really wanna avoid going into the infinite beta mode, i.e. "lemme just do this _>>one
more thing<<_ and then we'll surely release" but at the same time I want to stay
responsible and as such, I wanna make sure few things are done before we start showing this up for
people in Poland.
- [ ] some infra problem, the Polish option does appear in the select but it leads to 404
- [ ] getting rid of some terribly outdated pages: to say specific I would say lets at least deal
with files without En-Revision in most used
reference/* directories
- [ ] update parameter names to match the PHP's source code: while many files are technically
up-to-date (from revcheck's standpoint) they are using translated parameter names. I believe
this is what all documentations used to do in the old days. Now that we have named parameters it
means that people will get invalid information from the manual. I hope that there's some script
in doc-base that I can utilize to find such cases, otherwise I might end up writing something myself
- [ ] generally speaking I believe we should run all kinds of QA scripts that are available. Better
to do it now that the documentation is small rather than much later
- [ ] minor point: I remembered now that there are some translations embedded in the phd itself. I
think I even wrote a script eons ago that can show if the files went out of sync with the English
version. I have no clue of phd received much love in recent years but the Polish translations file
in its repo should be checked as well