Re: Time to publish the Polish translation?

On Sat, Oct 26, 2024, at 10:31 AM, André L F S Bacci wrote:
> On Sat, Oct 26, 2024 at 10:03 AM Maciej Sobaczewski <[email protected]> wrote:
>> The only one left is related to (I believe) some infrastructure bug,
>> where upon enabling the Polish language appears on the list but it leads
>> to 404 page. I believe the language was enabled long enough for the docs
>> to be built, but it's been some time ago and now I'm not 100% sure.
> 
> This is a symptom of an old issue. The definition list of "what is an active, building, publishable" translation is spread in various files, in various formats, in various repositories.
> 
> Running
> grep -ri --exclude-dir={.svn,.git} --color pt_BR .
> on a fresh checkout of doc-base reveal various places inside one repo.
> 
> This may be the time to erase all duplications, in all repositories in favor of a unique file, and then make doc-base/configure.php generate various formats that these instances can local import or are replaced from .dist files, or download from building machines, if in other repositories.

Looking at those results, it looks like they're all either related to CHM building or QA scripts.

The building and publishing of the web version of the documentation (and non-CHM downloads) are all controlled by a script in the https://github.com/php/systems repository (specifically `build-docs-rsync`) that gets the list of active languages from the `include/languages.inc` file in https://github.com/php/web-php

So I think we can just move Polish to the active languages list in `include/languages.inc` and debug from there if it doesn't just work.

The way the CHM files are built is not totally automated right now, so I don't think we need to worry too much about it until that changes.

More medium term, I think the list of active languages should be moved to `doc-base` instead of `web-php` so the documentation team has direct control over it.

Jim