| Hannes Magnusson 2007-10-06, 7:01 pm |
| On 10/6/07, Nuno Lopes <nlopess@php.net> wrote:
>
> I don't like this idea because the revision doesn't get bumped
> automatically. I think there'll be more problems that the little efforth of
> the translators to bump a no-op revision.
Is your time more worth than the time of 29 translators combined?
Selfish prick! :)
Bumping it automatically is the problem, not the solution.
We have almost 30 translations, and only 1 up2date.
Seriously, the Japanese translation is the only translation with over
50% content up to date.
Currently we have no way of knowing if the French translation is
missing critical fixes or if it simply needs to bump its revision
after the bunch of English-only-fixes to the docs the past months.
Given the fact phpdoc has been pretty much sleeping for the past few
months I have serious doubts that the French translation really is
that outdated.
If we bumped the (major&minor) revision manually we could (more)
accurately determine if the translation was really out of date and
warn the end-user if it really is.
> Please remember that not everybody that contributes documentation belongs to
> the phpdoc team and thus isn't aware of our latest practices. So, automatic
> things are the best things (tm).
Whoever commits the patch is responsible for it and should make sure
its "phpdocified" (proper ws, markup inline with the current
recommendations, entity usage...).
-Hannes
|