Re: [PHP-DOC] Getting more people involved.. bye bye Docbook

[Klaus Silveira]

On Mon, Aug 12, 2013 at 10:36 AM, Derick Rethans  wrote:

> On Sat, 10 Aug 2013, Hannes Magnusson wrote:
>
> > Keep in mind, no matter what format we choose we do need to roll our
> > own engine.
> >
> > > It would also be a big transition from docbook to another format.
> > > We'd definitely need a translation tool to help us. I'm not sure
> > > what is out there, but I can definitely say what is not out there: a
> > > docbook to our-custom-markdown formatter. That's another thing to
> > > keep in mind.
> >
> > Any off-the-shelf docbook->ascidoc/rST/markdown/whatever is not going
> > to work anyway, so it doesn't matter what is out there :)
>
> Hmm, sortof not. I have been using rST for ages, and all my articles are
> written in it: https://github.com/derickr/derickrethans-articles
>
> It has some custom things, such as the meta data, support for vimeo etc
> as rST allows for you own definitions. I use Zeta Components' converter
> to get from rST to XHTML and have written some modifications. It also
> helps that the same stack allows rST->docbook and docbook->rST. And the
> stack allows for easy enough modifications...
>
> cheers,
> Derick
>

What about references between articles? Is there a markdown extension that
allows this?

Re: [PHP-DOC] VCS Account Request: malukenho

[Klaus Silveira]

I'm not sure if i follow what you are trying to say. Anyway, which group
are you talking about? The only official one is phpdoc-pt...@lists.php.net.
That's the list with the most active translators, so, feel free to discuss
in portuguese there.

On Thu, Aug 8, 2013 at 7:02 PM, Jefersson Nathan  wrote:

> Ok! Got Klaus.
>
> Do not take offense to what I am telling here.
> I am concerned about the direction the story is taking.
>
> But answer me, how long the php manual nobody was broken and took no
> action!?
> I mean then that a book is more important than the state of the PHP manual?
>
> I even posted my outrage in the group with the translations, the state of
> the manual, and how they were treating it.
>
> I'm really wanting to help, so I got up, and I will raise issues without
> ever need!
>
> I'm not judging anyone, but that does not make sense!
>
> I'm sorry for anything I said, the more I love php and I will always fight
> for him to improve more and more.
>
>
> 2013/8/8 Klaus Silveira 
>
>> The pt_BR breaks easily because of the huge gap between the latest en
>> version and the pt_BR one. If you are really interested in helping, you
>> should read this article:
>>
>> https://wiki.php.net/doc/translations/pt_br
>>
>> This not only teaches you how to contribute to the brazilian translation,
>> but also defines the current focus of the translation. Translating one or
>> two files in separate books is not really useful to anyone. We have to
>> dedicate ourselves to the synchronization of the current books and most
>> critical articles, in order to stabilize the build and allow more
>> translators to join the group.
>>
>> If you are really interested in making a difference and helping the
>> group, you can discuss within the group list and ask what's the current
>> focus, who's working on which book, why the current version of the build is
>> broken, what was the latest commit, etc, etc.
>>
>> On Thu, Aug 8, 2013 at 2:51 PM, Rafael Jaques  wrote:
>>
>>> pt-BR docs breaks easily. While SVN commits just-in-time, commiting via
>>> PHPOE takes several days.
>>>
>>> And even with my SVN account, I'm not able to approve changes from other
>>> people.
>>>
>>> Um abraço,
>>> :: Rafael Jaques (phpit.com.br <http://www.phpit.com.br>)
>>> :: Cristão - Professor - Evangelista PHP
>>> :: "Se confessarmos os nossos pecados, ele é fiel e justo para nos
>>> perdoar os pecados, e nos purificar de toda a injustiça." (1 João 1:9)
>>>
>>>
>>> 2013/8/8 Felipe Barth 
>>>
>>>> I agree with some things Jefersson said. I had done the patch to fix
>>>> the manual and sent to the list pt-BR, but only after sending to the
>>>> general list is that the patch has been committed. Do not know if it's lack
>>>> of interest, which I believe is, are few people have a SVN account and few
>>>> free time to do the review and commit's.
>>>>
>>>> One way to solve this would be providing access to SVN for those who
>>>> have interest in contributing.
>>>>
>>>>
>>>> On Thu, Aug 8, 2013 at 8:33 AM, Jefersson Nathan wrote:
>>>>
>>>>> Yes I am currently working with this tool.
>>>>>
>>>>> However, I noticed a lack of interest on the part of the translation
>>>>> team of Portuguese Brazil. A long time we were getting the message 'The 
>>>>> PHP
>>>>> manual is broken' and nothing was done. Only after I got angry at the
>>>>> situation and decided to write to the team that had taken action.
>>>>>
>>>>> I'm trying to make a difference and help PHP to grow increasingly.
>>>>> I think they should give opportunity to those who want to contribute
>>>>> to truth.
>>>>>
>>>>> Moreover, the contribution made by the online tool (edit.php.net),
>>>>> take much too much to be commited.
>>>>>
>>>>>
>>>>> 2013/8/8 Hannes Magnusson 
>>>>>
>>>>>> Have you seen https://edit.php.net ?
>>>>>>
>>>>>> -Hannes
>>>>>>
>>>>>>
>>>>>> On Tue, Jun 25, 2013 at 10:45 AM, Jefersson Nathan 
>>>>>> wrote:
>>>>>> > Translate the documentation to my lang (Portuguese-BR)
>>>>>> >
>>>>>> >
>>>>>>
>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> *Jefersson Nathan*
>>>>> *Desenvolvedor Web - PHP Sergipe GU Founder*
>>>>> *http://www.phpse.net*
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>>
>>>> *Felipe Ismael Barth*Zend Certified Engineer PHP 5.3 
>>>> <http://www.zend.com/en/yellow-pages#show-ClientCandidateID=ZEND020390> 
>>>> (ZEND020390)Certified ITIL Foundation <http://www.itil-officialsite.com/> 
>>>> (16/01/2013)
>>>>
>>>>
>>>
>>
>>
>> --
>> Klaus Silveira
>> (011) 8564-2492
>> www.klaussilveira.com
>>
>
>
>
> --
> *Jefersson Nathan*
> *Desenvolvedor Web - PHP Sergipe GU Founder*
> *http://www.phpse.net*
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] VCS Account Request: malukenho

[Klaus Silveira]

The pt_BR breaks easily because of the huge gap between the latest en
version and the pt_BR one. If you are really interested in helping, you
should read this article:

https://wiki.php.net/doc/translations/pt_br

This not only teaches you how to contribute to the brazilian translation,
but also defines the current focus of the translation. Translating one or
two files in separate books is not really useful to anyone. We have to
dedicate ourselves to the synchronization of the current books and most
critical articles, in order to stabilize the build and allow more
translators to join the group.

If you are really interested in making a difference and helping the group,
you can discuss within the group list and ask what's the current focus,
who's working on which book, why the current version of the build is
broken, what was the latest commit, etc, etc.

On Thu, Aug 8, 2013 at 2:51 PM, Rafael Jaques  wrote:

> pt-BR docs breaks easily. While SVN commits just-in-time, commiting via
> PHPOE takes several days.
>
> And even with my SVN account, I'm not able to approve changes from other
> people.
>
> Um abraço,
> :: Rafael Jaques (phpit.com.br <http://www.phpit.com.br>)
> :: Cristão - Professor - Evangelista PHP
> :: "Se confessarmos os nossos pecados, ele é fiel e justo para nos perdoar
> os pecados, e nos purificar de toda a injustiça." (1 João 1:9)
>
>
> 2013/8/8 Felipe Barth 
>
>> I agree with some things Jefersson said. I had done the patch to fix the
>> manual and sent to the list pt-BR, but only after sending to the general
>> list is that the patch has been committed. Do not know if it's lack of
>> interest, which I believe is, are few people have a SVN account and few
>> free time to do the review and commit's.
>>
>> One way to solve this would be providing access to SVN for those who have 
>> interest
>> in contributing.
>>
>>
>> On Thu, Aug 8, 2013 at 8:33 AM, Jefersson Nathan  wrote:
>>
>>> Yes I am currently working with this tool.
>>>
>>> However, I noticed a lack of interest on the part of the translation
>>> team of Portuguese Brazil. A long time we were getting the message 'The PHP
>>> manual is broken' and nothing was done. Only after I got angry at the
>>> situation and decided to write to the team that had taken action.
>>>
>>> I'm trying to make a difference and help PHP to grow increasingly.
>>> I think they should give opportunity to those who want to contribute to
>>> truth.
>>>
>>> Moreover, the contribution made by the online tool (edit.php.net), take
>>> much too much to be commited.
>>>
>>>
>>> 2013/8/8 Hannes Magnusson 
>>>
>>>> Have you seen https://edit.php.net ?
>>>>
>>>> -Hannes
>>>>
>>>>
>>>> On Tue, Jun 25, 2013 at 10:45 AM, Jefersson Nathan 
>>>> wrote:
>>>> > Translate the documentation to my lang (Portuguese-BR)
>>>> >
>>>> >
>>>>
>>>
>>>
>>>
>>> --
>>> *Jefersson Nathan*
>>> *Desenvolvedor Web - PHP Sergipe GU Founder*
>>> *http://www.phpse.net*
>>>
>>
>>
>>
>> --
>>
>> *Felipe Ismael Barth*Zend Certified Engineer PHP 5.3 
>> <http://www.zend.com/en/yellow-pages#show-ClientCandidateID=ZEND020390> 
>> (ZEND020390)Certified ITIL Foundation <http://www.itil-officialsite.com/> 
>> (16/01/2013)
>>
>>
>


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Re: [PHP-DEV] Moving PHP documentation to Git repository

[Klaus Silveira]

On Tue, Jun 25, 2013 at 1:05 PM, David Soria Parra  wrote:

> On 2013-06-25, Ferenc Kovacs  wrote:
> > there were some initial discussion and work done on moving the docs to
> git,
> > see
> > https://wiki.php.net/doc/git
> >
> http://git.php.net/?p=3Dweb/doc-editor.git;a=3Dshortlog;h=3Drefs/heads/GIT_=
> > READY
> > http://marc.info/?l=3Dphpdoc&m=3D132321958514090&w=3D2
> >
> > but it seems that we lost momentum, but I think that this isn't a
> technical
> > problem, just lack of interest (svn and the online editor just works for
> > the regulars), maybe others have different opinions on this.
> > and I'm fairly certain that the slow integration of the patches also not
> a
> > technical problem as well.
> > I think that it would worth more to figure out and fix the underlying
> > problem which causes the current delay for integrating the incoming
> patches=
> > .
> > moving to git/github without fixining the underlying issue would only
> mean
> > that we switched to pull requests not getting accepted in a timely
> > manner(which is unfortunately common with our other git/github repos).
>
> generally speaking i am in favor in moving more and more to git. we lost
> momentum
> and I am stuck with a new job and RMing. I can help with technical
> questions
> but don't hav emuch time implementing it.
>

I'm also in favor of moving to Git. The amount of contributions to the
brazilian portuguese translation would be much more significant if we had a
streamlined contribution system, which pull requests on Github allow quite
easily. What are the current problems of Git migration?

Re: [PHP-DOC] Brazilian Portuguese help

[Klaus Silveira]

Shelly,

Please, read the Brazilian Portuguese Translation Manual in the wiki before
submitting any patches: https://wiki.php.net/doc/translations/pt_br

On Wed, Apr 24, 2013 at 12:55 PM, Kinn Coelho Julião  wrote:

> Hi Shelly,
> check edit.php.net to contribute!
> Feel free to ask me if you have any question (even in Portuguese).
>
> tnx,
>
> Kinn.
>
>
> 2013/4/22 Shelly Benmuyal 
>
>> Hello,
>> If you need help with the translation, please let me know, I would love
>> to help! I am brazilian, FYI.
>>
>> Best regards,
>>
>> Shelly Benmuyal.
>>
>>
>> Sent from my ASUS Pad
>
>

[PHP-DOC] Re: [DOC-PT-BR] This PHP Manual build is broken

[Klaus Silveira]

Tu testou local antes de commitar? Deu update nos repos (inclusive no en) e
fez o build?

On Tue, Aug 7, 2012 at 6:04 PM, Thiago H. Pojda wrote:

> ... and the log? :)
>
>
> Thiago Henrique Pojda
> +55 41 8856-7925
>
>
>
> On Tue, Aug 7, 2012 at 4:35 PM,  wrote:
>
> > The pt_BR build of the PHP Manual is broken, so it does not validate or
> > build. Please fix it! ;)
> >
> > Attached is the full log
> >
> > Love,
> > The docs.php.net server
> >
> >
> > --
> > PHP Brazilian Portuguese Documentation Mailing List (
> > http://php.net/manual/pt_BR/)
> > To unsubscribe, visit: http://www.php.net/unsub.php
> >
>

[PHP-DOC] Re: [DOC-PT-BR] Re: [PHP-DOC] SVN Account Request: kinncj

[Klaus Silveira]

On Mon, Jul 9, 2012 at 5:02 PM, Hannes Magnusson  wrote:

> Thats not entirely true.
> Most extensions are fairly self contained, especially the ones that
> aren't consider _core_ functionality.
> As long as the entity files (language-defs.ent and friends) are
> translated there should be no risks, especially for an extension that
> doesn't get changed frequently like cURL.


The thing that you don't understand is how the pt_BR is outdated and out of
sync. It is truly volatile and hacked-together. Some commits were made just
to fix missing references, instead of syncing the whole affected document.
Recently we had updates to the cURL extension and the build broke due to
missing references. Same happened when SimpleXML was updated. Also, our
build tends to break with apparently harmless EN updates.

Even though cURL isn't changed frequently, there's a 2 or 3 year gap
between EN and pt_BR. This applies for lot's of documents in pt_BR. We're
currently fixing this, but "language" and "security" are much more
important than "reference" right now.

[PHP-DOC] Re: [DOC-PT-BR] Re: [PHP-DOC] SVN Account Request: kinncj

[Klaus Silveira]

pt_BR is completely out of sync with EN, making the entire translation
effort volatile. The current focus of the translation is syncing "language"
and "security", as well other crucial parts. "reference" is our last
priority right now.

If someone syncs "reference", either cURL or any other part of the
reference, the chance that the build will break due to non-existing
entities or references is huge. If we focus on crucial parts of the manual
that are outdated, this chance is almost none. This minimizes the effort of
the entire translation group. Accepting patches blindly and thinking any
commit is good has caused the mess that pt_BR encounters itself right now.

On Mon, Jul 9, 2012 at 4:41 PM, Hannes Magnusson  wrote:

> On Mon, Jul 9, 2012 at 8:17 PM, Klaus Silveira
>  wrote:
> > Yes, you can. You can apply patches sent by users of the online editor,
> as
> > long as you credit them. However, read the translation rules before any
> > commit: http://wiki.php.net/doc/translations/pt_br. The most important
> rule
> > is: TEST before commiting.
> >
> > You should also read, and follow, the docs manual:
> > https://wiki.php.net/doc/howto. And make sure your local build is synced
> > with both EN and pt_BR. The patches currently awaiting for approval in
> the
> > online editor have been rejected since they break the build and are not
> > following the translation rules.
> >
> > By the way, cURL is not the focus of pt_BR right now.
>
> What is, and how can I see what the focus is? o.O
>
> -Hannes
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Re: [DOC-PT-BR] Re: [PHP-DOC] SVN Account Request: kinncj

[Klaus Silveira]

Yes, you can. You can apply patches sent by users of the online editor, as
long as you credit them. However, read the translation rules before any
commit: http://wiki.php.net/doc/translations/pt_br. The most important rule
is: TEST before commiting.

You should also read, and follow, the docs manual:
https://wiki.php.net/doc/howto. And make sure your local build is synced
with both EN and pt_BR. The patches currently awaiting for approval in the
online editor have been rejected since they break the build and are not
following the translation rules.

By the way, cURL is not the focus of pt_BR right now.

On Mon, Jul 9, 2012 at 2:28 PM, Kinn Coelho Julião  wrote:

> Hi hannes,
> I'm finish to fix/update/translate the cURL docs to pt_BR, but I'll pay
> atention to some patches and review them this week. I see u talk that we
> can made reviews and merges(approve patches) over the online editor, is it
> true?
>
> Sent from my iPhone
>
> On 09/07/2012, at 14:13, Hannes Magnusson 
> wrote:
>
> > Hi Kinn.
> > How is it going?
> >
> > Started reviewing and merging the outstanding patch queue?
> > Or translated something yourself yet?
> >
> > -Hannes
> >
> > On Thu, Jun 21, 2012 at 11:18 PM, Hannes Magnusson
> >  wrote:
> >> Done
> >>
> >> -Hannes
> >>
> >> On Wed, Jun 20, 2012 at 3:59 PM, Felipe Pena 
> wrote:
> >>> 2012/6/4 Hannes Magnusson :
> >>>> On Wed, May 30, 2012 at 2:20 PM, Eriksen Costa <
> eriksenco...@gmail.com> wrote:
> >>>>>
> >>>>> +1 for Kinn account request. He can help a lot with all those
> out-of-date and waiting for review docs.
> >>>>
> >>>>
> >>>> I.. do not know who you are - and don't see your name on master,
> sorry.
> >>>> What is your php.net username?
> >>>>
> >>>> -Hannes
> >>>>
> >>>
> >>> Hi, Can anyone grant the Kinn (kinncj) account? I've committed some
> >>> patches from him.
> >>>
> >>> Thanks.
> >>>
> >>> --
> >>> Regards,
> >>> Felipe Pena
>
> --
> PHP Brazilian Portuguese Documentation Mailing List (
> http://php.net/manual/pt_BR/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] About doc.php.net cron

[Klaus Silveira]

I thought the online editor was fed from doc.php.net data.

On Wed, Jul 4, 2012 at 9:53 AM, Hannes Magnusson  wrote:

> On Wed, Jul 4, 2012 at 1:49 PM, Klaus Silveira 
> wrote:
> >
> > On Wed, Jul 4, 2012 at 9:08 AM, Hannes Magnusson
> >  wrote:
> >>
> >> On Tue, Jul 3, 2012 at 11:23 PM, Klaus Silveira 
> >> wrote:
> >> > Is the include/rfc/rfc-cron.php cron job running OK? I have noticed
> that
> >> > the
> >> > database doesn't seem to be updated.
> >>
> >> No docweb cronjobs seem to be running..
> >>
> >> Out of curiosity, what are you using the rfc page for?
> >> I don't think it was ever used, and I believe the rfc process in the
> >> wiki should be used instead.
> >>
> > Well, i'm just worried that revcheck isn't updating correctly:
> > http://doc.php.net/php/pt_BR/
> >
> > Probably due to those missing cronjobs. It should read some files from
> the
> > translation repository from time to time, parse and then update the
> SQLite
> > database.
> >
>
> Isn't that functionality built into the online editor too?
>
> I would really like to kill doc.php.net completely as the OE has taken
> over most of its features already.
>
> -Hannes
>

[PHP-DOC] About doc.php.net cron

[Klaus Silveira]

Is the include/rfc/rfc-cron.php cron job running OK? I have noticed that
the database doesn't seem to be updated.

Re: [PHP-DOC] doc.php.net build logs

[Klaus Silveira]

That's a very nice addition, Hannes. Thanks! This will make my life much
easier when monitoring/managing the pt_BR build.

On Sat, Jun 9, 2012 at 8:18 AM, Hannes Magnusson  wrote:

> Hi
>
> All build logs for doc.php.net are now available on
> http://doc.php.net/logs/
>
> The folders are -MM-DD-HH, and the server builds everything
> currently 6times a day (we could increase that.. it only takes an hour
> to build everything..).
> Currently it keeps the history forever.. :P
>
> You can easily see which languages are being built, which formats and
> why its failing, and whatever you'd like to know.
>
> Again, the script is it git[1] if you'd like to change anything.
>
> -Hannes
>
> [1]
> http://git.php.net/?p=systems.git;a=blob;f=build-docs-snapshots;h=b753189717289c2ac1f71ea17f38fe1a2e5e26d6;hb=HEAD
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Join the Documentation Team

[Klaus Silveira]

Hello Vanildo,

First off all, you need to understand how the documentation works.
Please, take a look at those pages before getting your hands dirty:

http://doc.php.net/php/dochowto/
https://wiki.php.net/doc/editor

After reading those, you can start using the online editor to submit
your translations: https://edit.php.net/

The official mailing list of the brazilian portuguese documentation team is
phpdoc-pt...@lists.php.net. You should get in touch with us if you need
anything. Also, we're currently re-organizing the translation and you might
hear some news pretty soon.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Syncing your translation with the EN build

[Klaus Silveira]

Hello Yannick,

Yes, the editor is very helpful, specially when updating obsolete
translations to more recent revisions. However, most of the problems we're
facing have to be fixed directly in the SVN.

Thanks for the tips, Hannes. :)

On Thu, Mar 22, 2012 at 9:36 AM, Yannick Torrès wrote:

> Hi Klaus,
>
> In addition with Hannes say, perhaps you can start using the online editor
> (https://edit.php.net).
> This tools make a lot of things in the background who will help you on
> common tasks with translation.
>
> Best,
> Yannick
>
>
> 2012/3/22 Hannes Magnusson 
>
>> On Wed, Mar 21, 2012 at 21:30, Klaus Silveira 
>> wrote:
>> > Dear maintainers,
>> >
>> > I have a tricky question that you guys might be able to help by sharing
>> your
>> > experiences. The pt_BR build of the PHP documentation is very obsolete.
>> > There are a lot of files that don't exist anymore in the EN build and
>> lot's
>> > of files from the current EN missing from the pt_BR build. Not only the
>> > references are obsolete, the actual files are missing or should be
>> removed.
>> > Is there a quick way of syncing the two again, so we can start working
>> on a
>> > more stable and updated pt_BR build?
>>
>> The configuration scripts will automatically fallback to English files
>> when files are missing in the translations - as long as the "container
>> files" aren't overwritten (i.e. the files that contain the entity
>> references).
>>
>> I would start with either making sure the "container files" are
>> up2pdate, or removing them (files like book.xml which contain entity
>> includes of classes and functions).
>> That will ensure the fallback will kick in, and the English
>> translation will be included when the translation is missing some
>> files.
>>
>> If you have a lot of files in the translation that no longer exists in
>> the english version, then those files have most probably be refactored
>> into smaller chunks. They could also simply have been renamed (which
>> we really really try to avoid exactly to prevent this sort of issues),
>> but I would recommend you track down when the file was removed and why
>> - just so you won't have to translate the entire thing again for no
>> reason.
>>
>>
>> I'm not a translator, so I can't say what other translations do..
>> hopefully someone can explain what they do in these cases :]
>>
>> -Hannes
>>
>
>

[PHP-DOC] Syncing your translation with the EN build

[Klaus Silveira]

Dear maintainers,

I have a tricky question that you guys might be able to help by sharing
your experiences. The pt_BR build of the PHP documentation is very
obsolete. There are a lot of files that don't exist anymore in the EN build
and lot's of files from the current EN missing from the pt_BR build. Not
only the references are obsolete, the actual files are missing or should be
removed. Is there a quick way of syncing the two again, so we can start
working on a more stable and updated pt_BR build?

I'm using Meld to compare the two folders, en and pt_BR. Do you guys have
any similar workflow? Ideas? Experiences? Thanks! :)


ps.: I'm talking about years old desynchronization. Some files and
references have been manually synced, but the entire manual is messy.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] GSoC 2012

[Klaus Silveira]

There are many parts of the documentation that could use clear examples in
*code*, specially extensions like SSH and LDAP.

On Wed, Feb 22, 2012 at 11:43 AM, Derick Rethans  wrote:

> On Wed, 22 Feb 2012, Klaus Silveira wrote:
>
> > What about the documentation itself, guys? The tools sure need help, but
> > the documentation could benefit from a code rush.
>
> It's called Google Summer of *Code*.
>
> Derick
>

Re: [PHP-DOC] GSoC 2012

[Klaus Silveira]

What about the documentation itself, guys? The tools sure need help, but
the documentation could benefit from a code rush.

On Wed, Feb 22, 2012 at 9:09 AM, Alexander Moskaliov wrote:

> Hello!
>
> 2012/2/22 Philip Olson :
> >  - Online Editor
> >- Possible mentors: Alexander, Yannick
> Sorry, but I can't be mentor for some personal reasons(such as my bad
> english, wedding, move in new home, etc.) =)
> Try ask Yannick.
>


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Docs offline?

[Klaus Silveira]

I just noticed that the documentation is offline, as well the main PHP.net
news. Is this a major problem? How can we help?

Re: [PHP-DOC] Documentation access

[Klaus Silveira]

First off all, you need to understand how the documentation works. Please,
take a look at those pages before getting your hands dirty:

http://doc.php.net/php/dochowto/
https://wiki.php.net/doc/builds
https://wiki.php.net/doc/phd
https://wiki.php.net/doc/editor

After reading those, you can start using the online editor to submit your
translations as an anonymous contributor. After a few good patches, you can
request an SVN account if you want to do work that the editor does not
allow you to do.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Contribute to the PHP documentation

[Klaus Silveira]

Hello Bruno,

Do you wish to contribute for the brazilian translation or the official
documentation? Have you submitted any patches recently? Or maybe some
translations/fixes as an anonymous user on the editor?

On Sun, Dec 4, 2011 at 8:07 AM, Rios  wrote:

> Hello,
>
> My name is Bruno and I live in Rio de Janeiro, Brazil. I want to
> contribute with PHP documentation.
>
> Thank you very much.
>

Re: [PHP-DOC] SVN Account Request: andregolvea

[Klaus Silveira]

Do you have any submitted patches? Have you read the HOWTO?

http://doc.php.net/php/pt_BR/dochowto

On Sun, Nov 20, 2011 at 10:25 AM, Rafael Jaques  wrote:

> Brazilian Portuguese?
>
> Help us in our new efforts to get the translation up-to-date and you may
> receive and SVN account.
>
> Would you like to join?
>
> :: Rafael Jaques
> :: http://www.phpit.com.br - http://www.twitter.com/rafajaques
> :: Cristão - Professor - PHP Developer - Gremista - Colunista MX Studio -
> Linux User: #422354
> :: "Se confessarmos os nossos pecados, ele é fiel e justo para nos perdoar
> os pecados, e nos purificar de toda a injustiça." (1 João 1:9)
>
>
> 2011/11/20 André Golvea 
>
>> Translating the documentation
>>
>
>


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Error in pt-BR translation. Need help!

[Klaus Silveira]

The pt_BR translation build WAS broken in the last SVN revision. I have
submitted a patch that fixed the build. However, i believe that this
reported failure might be a bug in the edit.php.net, since there's nothing
wrong in the build. I have also checked the DE translation build.

On Mon, Nov 14, 2011 at 2:00 PM, Philip Olson  wrote:

>
> Then let's disable builder emails until this bug is resolved. The builder
> and online editor are the same.
>
> And I'm not sure if the validation system integrates outstanding patches
> before running the check, but I don't imagine it should.
>
> Philip
>
> On Nov 14, 2011, at 7:56 AM, Rafael Jaques wrote:
>
> > But that's the notice we received by the builder, via email...
> >
> > :: Rafael Jaques
> > :: http://www.phpit.com.br - http://www.twitter.com/rafajaques
> > :: Cristão - Professor - PHP Developer - Gremista - Colunista MX Studio
> - Linux User: #422354
> > :: "Se confessarmos os nossos pecados, ele é fiel e justo para nos
> perdoar os pecados, e nos purificar de toda a injustiça." (1 João 1:9)
> >
> >
> > 2011/11/14 Philip Olson 
> >
> > I think the online editor is experiencing a bug, as both pt_BR/ and de/
> build fine.
> >
> >  http://docs.php.net/download-docs.php?sizes=1
> >
> > Regards,
> > Philip
> >
> > On Nov 14, 2011, at 7:44 AM, Nikita Popov wrote:
> >
> > > We are experiencing the same issue with the German translation. If I
> > > run a build check in the online editor, it fails with a similar
> > > message to the one posted. If I do a locale configure.php run
> > > everything is fine (or do I need to pass some arg for it make all
> > > checks?)
> > >
> > > Nikita
> > >
> > > On Mon, Nov 14, 2011 at 4:38 PM, Rafael Jaques  wrote:
> > >> Hi pals!
> > >> I'm experiencing this difficulties...
> > >> The error log says that:
> > >> Saving it... OK
> > >> Creating file
> > >> /local/web/sites/
> edit.php.net/data/phpdoc-all/doc-base/entities/file-entities.ent...
> > >> done
> > >> Checking for if we should generate a simplified file... no
> > >> Checking whether to save an invalid .manual.xml... no
> > >> Loading and parsing manual.xml... failed.
> > >>
> > >> ERROR
> > >> (file:local/web/sites/
> edit.php.net/data/phpdoc-all/pt_BR/reference/mysqli/entities.mysqli.xml:1:2
> )
> > >>
> &.local.web.sites.edit.php.net.data.phpdoc-all.pt-BR.reference.mysqli.mysqli.affected-rows;
> > >> --^
> > >>  xmlParseEntityRef: no name
> > >>
> > >>
> > >> Previous errors too severe. Stopping here.
> > >> Some sample of the file:
> > >> 
> > >>
> &.local.web.sites.edit.php.net.data.phpdoc-all.pt-BR.reference.mysqli.mysqli.autocommit;
> > >>
> &.local.web.sites.edit.php.net.data.phpdoc-all.pt-BR.reference.mysqli.mysqli.change-user;
> > >>
> &.local.web.sites.edit.php.net.data.phpdoc-all.pt-BR.reference.mysqli.mysqli.character-set-name;
> > >> ...
> > >> But I don't know what's wrong!
> > >> Can someone help me?
> > >> :: Rafael Jaques
> > >> :: http://www.phpit.com.br - http://www.twitter.com/rafajaques
> > >> :: Cristão - Professor - PHP Developer - Gremista - Colunista MX
> Studio -
> > >> Linux User: #422354
> > >> :: "Se confessarmos os nossos pecados, ele é fiel e justo para nos
> perdoar
> > >> os pecados, e nos purificar de toda a injustiça." (1 João 1:9)
> > >>
> >
> >
>
>


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] SVN Account Request: klaussilveira

[Klaus Silveira]

Hello Hannes,

I already submitted a patch for fixing the current build of the pt_BR
translation. It's somewhere here or at the php-doc-pt_br list. Felipe was
taking care of that since i don't have an SVN account. I'm requesting one
so i can be more useful. :D

On Fri, Nov 11, 2011 at 9:44 PM, Hannes Magnusson <
hannes.magnus...@gmail.com> wrote:

> On Fri, Nov 11, 2011 at 22:48, Klaus Silveira 
> wrote:
> > Helping in the pt_BR documentation translation effort, as well as the
> core documentation.
> >
>
> I was sure I had replied;
> "Ouh. Shuttup. Fix it yourself:"
> But apparently I never sent that mail...
> So here it is; Fix it yourself. You have karma now \o/ :D
>
> -Hannes
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Quality assurance in documentation translation

[Klaus Silveira]

I have implemented a small CI for my translation efforts on the pt_BR
build, using Jenkins. So far, so good. I'm messing around with some of the
scripts in available in doc-base, but some of their output has to be
customized in order to actually provide useful information for Jenkins.

I believe that a full Jenkins-based CI for the official documentation and
it's translations would be great, however, be prepared for some very
intensive processes. It's going to be hard on the servers.

On Fri, Nov 11, 2011 at 10:10 PM, Hannes Magnusson <
hannes.magnus...@gmail.com> wrote:

> On Sat, Nov 12, 2011 at 00:56, Ferenc Kovacs  wrote:
> >> > Sorry, I don't get the "correct" part, but about the multiple
> platforms:
> >>
> >> Our usage of libxml2 requires minimum 2gb ram (on success).
> >> On failures.. ~8gb ram should "work".
> >>
> >
> > thats somehow in line what I remembered, thanks for the clarification
> > though!
> >
> >>
> >> > Running concurrent builds on every slave/platform isn't
> a necessity just
> >> > a
> >> > possibility, so if running the docbuilds on one specific platform is
> >> > enough,
> >> > then we can do that of course.
> >>
> >>
> >> You are talking about the ci.qa.php.net jenkins builds here, right?
> >>
> >
> > yeah, I tried to be clear on that "As I mentioned in the Jenkins RFC
> [..]
> > The setup would be easy imo (only reporting success/error making the
> console
> > output/logs available for debuging the issue), but the memory
> requirements
> > make it in-feasible for the current cluster.
>
> Daniel:
> Something you can help us with?
>
> -Hannes
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] SVN Account Request: klaussilveira

[Klaus Silveira]

Helping in the pt_BR documentation translation effort, as well as the core 
documentation.

[PHP-DOC] Re: [DOC-PT-BR] Patch for the broken documentation build (pt_BR translation)

[Klaus Silveira]

Thank you for the reply, Felipe. I was worried that the translation could
be abandoned! :)


ps.: Sprint de tradução no feriadão? :D

On Fri, Nov 11, 2011 at 6:43 PM, Felipe Pena  wrote:

> 2011/11/11 Klaus Silveira :
> > Well, the current build of the pt_BR translation is broken. After messing
> > around, i came up with this small patch to get the build going again. The
> > build has been broken for weeks now, maybe months. This is terrible for
> > people who want to contribute, since it looks like the translation is
> > abandoned. There are also many anonymous commits waiting/begging to be
> > analyzed.
> > Can anyone please step up and help? No one answered the last emails in
> the
> > pt_BR translation mailing list, so i'm requesting aid from other
> > translations or the official doc team. Thanks in advance, guys!
> >
>
> Ok, I'll take a look. (holiday :D)
>
> Thanks.
>
> --
> Regards,
> Felipe Pena
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Synchronize local translation with original

[Klaus Silveira]

That's perfect, Hannes. Thank you.

On Fri, Nov 11, 2011 at 3:04 PM, Hannes Magnusson <
hannes.magnus...@gmail.com> wrote:

> On Fri, Nov 11, 2011 at 17:43, Klaus Silveira 
> wrote:
> > Hello guys,
> > How can i synchronize a local translation with the original one? The
> current
> > brazilian translation SVN lacks a lot of new files from the current
> manual.
>
> If there is a missing file in the translations, the file will
> automatically be "entity includes" from the english translation.
>
> However, ff the translation overrides the "container file" (i.e.
> book.xml, or similar files that contain a lot of entity includes) then
> the new entity includes introduced to those files will not
> automatically get the new english chunks within that "container".
>
> If you simply remove that "container" the translation will
> automagically get the new files added to the english translation.
>
> Does that answer your question?
>
> -Hannes
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Quality assurance in documentation translation

[Klaus Silveira]

Hello,

I curious about the tools available in the doc-base that allow translators
to control the quality of the documentation build. Are those tests run by
configure.php? Maybe a phing build script could help the quality assurance
of the translation.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Patch for the broken documentation build (pt_BR translation)

[Klaus Silveira]

Well, the current build of the pt_BR translation is broken. After messing
around, i came up with this small patch to get the build going again. The
build has been broken for weeks now, maybe months. This is terrible for
people who want to contribute, since it looks like the translation is
abandoned. There are also many anonymous commits waiting/begging to be
analyzed.

Can anyone please step up and help? No one answered the last emails in the
pt_BR translation mailing list, so i'm requesting aid from other
translations or the official doc team. Thanks in advance, guys!

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com
Index: pt_BR/language/oop5.xml
===
--- pt_BR/language/oop5.xml (revision 319071)
+++ pt_BR/language/oop5.xml (working copy)
@@ -40,6 +40,7 @@
   &language.oop5.static;
   &language.oop5.abstract;
   &language.oop5.interfaces;
+  &language.oop5.traits;
   &language.oop5.overloading;
   &language.oop5.iterations;
   &language.oop5.patterns;
@@ -51,6 +52,7 @@
   &language.oop5.late-static-bindings;
   &language.oop5.references;
   &language.oop5.serialization;
+  &language.oop5.changelog;
 
  
 

[PHP-DOC] Synchronize local translation with original

[Klaus Silveira]

Hello guys,

How can i synchronize a local translation with the original one? The
current brazilian translation SVN lacks a lot of new files from the current
manual.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Is the brazilian translation effort still active?

[Klaus Silveira]

All right, thanks for the info Alexey. :D

On Tue, Nov 8, 2011 at 4:50 PM, Alexey Shein  wrote:

> According to the docs your translation has some links to the missed
> file (in your translation) with id "language.oop5.traits", i.e. traits
> documentation. You don't need svn account for building, you can check
> out doc sources anonymously and check your patches locally. See
> https://wiki.php.net/doc/howto/gettingstarted to get started,
> basically, it's just (replace ru with your lang code):
> $ svn co https://svn.php.net/repository/phpdoc/modules/doc-ru
> $ cd doc-ru
> translate translate translate
> $ doc-base/configure.php --with-lang=ru
> If you need more error detalization you can do
> $ doc-base/configure.php --with-lang=ru --enable-xml-details
> but be careful that thing eats a lot of memory.
>
> More options are available through doc-base/configure.php --help
>
> After identifying and fixing the problem, send the patch to the list,
> somebody will eventually commit it. After sending a couple of patches
> you will get access on the translation, that's how geting over
> unmaintaned translation is done, I personally went through it too :)
>
> Good luck!
>
> 2011/11/8 Klaus Silveira :
> > I trying to get those errors fixed using the edit.php.net, but i can't
> test
> > because i don't have an SVN account and no one can approve any commits i
> > make.
> > Maybe someone from the official PHPDoc list can help out? The broken
> build
> > is really a sign that the translation effort is abandoned. :(
> >
> > On Tue, Nov 8, 2011 at 2:53 PM, Richard Quadling 
> > wrote:
> >>
> >> On 8 November 2011 16:33, Klaus Silveira 
> >> wrote:
> >> >
> >> > The build has been broken for a few weeks now and there's no activity
> in
> >> > the mailing list. Is anyone still active?
> >> >
> >> > --
> >> > Klaus Silveira
> >> > (011) 8564-2492
> >> > www.klaussilveira.com
> >>
> >> configure [1] for pt_BR is giving the following errors ...
> >>
> >> Validating manual.xml... failed.
> >>
> >> The document didn't validate, here are the errors I got:
> >> (If this isn't enough information, try again with --enable-xml-details)
> >>  IDREF attribute linkend references an unknown ID "language.oop5.traits"
> >>  IDREF attribute linkend references an unknown ID "language.oop5.traits"
> >>
> >> Regards,
> >>
> >> Richard.
> >>
> >> [1] http://oti1.php.net/logs/configure_pt_BR.log
> >> --
> >> Richard Quadling
> >> Twitter : EE : Zend : PHPDoc : Fantasy Shopper
> >> @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY : bit.ly/lFnVea :
> >> fan.sh/6/370
> >
> >
> >
> > --
> > Klaus Silveira
> > (011) 8564-2492
> > www.klaussilveira.com
> >
>
>
>
> --
> Regards,
> Shein Alexey
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

Re: [PHP-DOC] Is the brazilian translation effort still active?

[Klaus Silveira]

I trying to get those errors fixed using the edit.php.net, but i can't test
because i don't have an SVN account and no one can approve any commits i
make.

Maybe someone from the official PHPDoc list can help out? The broken build
is really a sign that the translation effort is abandoned. :(

On Tue, Nov 8, 2011 at 2:53 PM, Richard Quadling wrote:

> On 8 November 2011 16:33, Klaus Silveira 
> wrote:
> >
> > The build has been broken for a few weeks now and there's no activity in
> the mailing list. Is anyone still active?
> >
> > --
> > Klaus Silveira
> > (011) 8564-2492
> > www.klaussilveira.com
>
> configure [1] for pt_BR is giving the following errors ...
>
> Validating manual.xml... failed.
>
> The document didn't validate, here are the errors I got:
> (If this isn't enough information, try again with --enable-xml-details)
>  IDREF attribute linkend references an unknown ID "language.oop5.traits"
>  IDREF attribute linkend references an unknown ID "language.oop5.traits"
>
> Regards,
>
> Richard.
>
> [1] http://oti1.php.net/logs/configure_pt_BR.log
> --
> Richard Quadling
> Twitter : EE : Zend : PHPDoc : Fantasy Shopper
> @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY : bit.ly/lFnVea :
> fan.sh/6/370
>



-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Is the brazilian translation effort still active?

[Klaus Silveira]

The build has been broken for a few weeks now and there's no activity in
the mailing list. Is anyone still active?

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] SVN account request: klaus

[Klaus Silveira]

Requesting an SVN account for helping the brazilian translation team of the
PHP documentation, as well helping maintain the English documentation.

ps.: Few commits under the #12063 anonymous login.

-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com

[PHP-DOC] Brazilian portuguese translation of the PHP Manual

[Klaus Silveira]

I'm interested in helping with the translation of the PHP Manual. I couldn't
find any information on the official PHP website, so i'm asking here guys.
Thank you for the attention.


-- 
Klaus Silveira
(011) 8564-2492
www.klaussilveira.com