From:	Philip Olson	Date:	Fri Mar 28 10:07:43 2008
Subject:	Re: a translations update

On 28 Mar 2008, at 04:23, Hannes Magnusson wrote:

> On Mon, Mar 10, 2008 at 2:23 AM, Philip Olson <philip@roshambo.org>  
> wrote:
>> Greetings translators and all-
>>
>> In the coming days I will be updating the translations (phpdoc-
>> {lang}) so that the translations will build again, and from there we
>> can resume the daily doc builds.
>
> What is the status on this?

It's chugging along. I'm having trouble getting over the guilt of  
deleting content but am slowly overcoming it. Many active ones build  
so far. FR is catching up on its own. BG, DE, JA, PT_BR, and RU all  
caught up on their own. I updated several others to built too, and am  
about to delete 99 reference.xml files in ES now. :O  Do note that the  
PRE_REF_CLEANUP CVS tag is used before these type of changes/ 
deletions, and all deleted files are available in the CVS Attic too.

> We've been waiting now for over 3months to push out new builds..
> I would really really like to push out new builds on weekly basis as
> of next Friday.

For the longest time your opinion was to push out the builds when PHP  
5.3 was released. Not sure what happened three months ago but  
regardless yes, it's a problem that we aren't building. However, I  
don't think a strict timeline is doable but see below.

> Unless anyone objects then here is my plan:
> All translations that do _not_ build by Friday will be _removed_  
> from phpweb.
> All translations that _do_ build will be built and pushed out to  
> mirrors.

We're not quite there yet. I urge people to come up with ideas to help  
smooth this process. One idea is to add an "Other" option in the  
language select box that if selected opens a page explaining the  
situation, including information on how to help translate and why so  
many languages suddenly disappeared. Also, we can keep all languages  
(however old they may be) on the doc dev server (docs.php.net) ...

As for phpweb, I count about 11/31 as at least semi-active, whereas  
the rest inactive. The 11:

   [en] => English (builds)
   [bg] => Bulgarian (builds)
   [pt_BR] => Brazilian Portuguese (builds)
   [fr] => French (catching up)
   [de] => German (builds)
   [it] => Italian
   [ja] => Japanese (builds)
   [pl] => Polish
   [ro] => Romanian
   [ru] => Russian (builds)
   [es] => Spanish

I think we can get all these to build by next Friday, mark the rest as  
inactive in phpweb, as long as an idea like "Other" is implemented.  
And as other translations become active again, they become active  
within phpweb. And by phpweb we mean show up (rsynced) to php.net  
mirrors.

> Every week all translations will be rebuilt and pushed out.
> If a translation suddenly starts building, it will be pushed out to  
> mirrors.


Sometime here all translations will build, but that doesn't mean they  
are up to date. Granted it can be debated if mixing "if they build  
since the big change" and "taking dead translations offline" but it  
seems like the perfect time. All translations should build so new  
translators can work on them, but most should remain offline until the  
appropriate time.

Regards,
Philip