On 28 Mar 2008, at 10:02, Hannes Magnusson wrote:
On Fri, Mar 28, 2008 at 5:07 PM, Philip Olson <[EMAIL PROTECTED]>
wrote:
On 28 Mar 2008, at 04:23, Hannes Magnusson wrote:
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.
15days was to small window. Since I thought 5.3 was somewhere around
the corner it sounded just as good as any other idea to roll the docs
with 5.3. I however never got any feedback on that idea
(http://php.markmail.org/message/ib2x6pwkz533a7gb) and 5.3 is nowhere
near a release.
I think we do need a strict timeline. Just see what happened with the
loose timeline, "noone" is doing anything and documentation fixes
since last November can't be pushed out because we are waiting for
dead translations, which noone is working on, to build.
We are miscommunicating.
Several translations now build, some of which were updated in the last
month or two. Others are catching up. It's a minority of total
translations, but this is our reality.
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
A good chunk of translation "requests" to phpdoc@ and php-webmaster@
go unanswered and most of the translation lists are dead, you think we
suddenly start to care because there is yet another page telling
people to mail the lists?
This page is for both users of the PHP Manual as well as translators.
Yes, people do care. It is to explain why [suddenly] 2/3 of the
translations seemingly disappeared, and also offers yet another path
for people to find themselves helping the PHP project. Writing such a
page is worth it, doesn't hurt, I'll write it.
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.
http://php.markmail.org/message/q3ezv3w5nd2a2asf
Can we please start taking some actions rather then discuss these
things to death again?
That all changed when the massive new reference structure started to
gain steam which caused every translation to be outdated and no longer
build. However, not sure why I seemingly disappeared from that
thread... sorry everyone about that. But today we are speaking about
taking action.
All I want is to push out manual updates with regular intervals, not
twice a year, and I want completely useless translations gone so they
don't lie to our users with bogus or incomplete information.
Everyone here wants the manual to build at least weekly. Earlier today
I proposed 11 translations for us to have online, whereas the rest go
offline. Doing so means weekly builds again, starting a week from now.
seems like the perfect time. All translations should build so new
translators can work on them,
I completely disagree. There is absolutely no point in wasting anyones
time to get translations like Arabic to build.
It hasn't built for years - and there hasn't been a commit there for
even more years.
That translation is completely dead, and wasting anyones time trying
to get it to build is flat out wrong.
It is without a doubt lot easier to start from scratch.
Same applies to most of the other translations that haven't been
touched for years.
I dare you to try one file. Any file, any file at all. Here is one
easy for you: phpdoc/en/language/functions.xml
Now pick a translation. Any translation. Lets say Spanish. It has had
some commits over the years and is in your semi-active-list.
http://cvs.php.net/viewvc.cgi/phpdoc/en/language/functions.xml?r1=1.41&r2=1.69&view=patch
The idea is to focus on getting those 11 online this week, then only
those 11 will be online via phpweb. Whether the others build or not
does not affect this. Earlier when you wrote that translations should
go online as soon as they build, I expressed my view that whether
something builds should not be the factor there. A truly outdated
translation may build but it's outdated and should be offline until
proven otherwise. But if it builds, simply adding some text and typing
'php configure.php' will let people know if their changes are okay...
future translations that is...
Do you honestly think its easier to update the file rather than
rewrite it?
I don't know, that's case-by-case and something for translators to
decide.
Regards,
Philip
