Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969379432 php.internals:40820
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.217.14 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:to:subject:cc:in-reply-to:mime-version
         :content-type:references;
        b=BJO0+yuktjuzvsTZzeF+vHreOTq4Uxbcsgt3JvedbLz9l1HR0NIl1I9MmIfdDW3XIZ
         5W7nmQ2m8Jsx88gDCN5hgwq37Npnn/ucSoFhz4vq0uBgTXjZ6LCOpjEjNsAuTqXCfwWT
         kB8j0iDKVPICTigxkyCxjUuU+Zu8K7NvZTkME=
Message-ID: <c0e7fa7f0810010707r724c089dv61bde6763b34898@mail.gmail.com>
Date: Wed, 1 Oct 2008 11:07:13 -0300
To: "Hannes Magnusson" <hannes.magnusson@gmail.com>
Cc: "PHP Development" <internals@lists.php.net>, 
	"PHP Documentation ML" <phpdoc@lists.php.net>, 
	"Philip Olson" <philip@php.net>
In-Reply-To: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com>
MIME-Version: 1.0
Content-Type: multipart/alternative; 
	boundary="----=_Part_84691_5515947.1222870033283"
References: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com>
Subject: Re: [PHP-DOC] [DOC] Commit messages dead?
From: thiago.pojda@gmail.com ("Thiago H. Pojda")

------=_Part_84691_5515947.1222870033283
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

On Wed, Oct 1, 2008 at 10:39 AM, Hannes Magnusson <
hannes.magnusson@gmail.com> wrote:

> Hi all
>
> It looks like [DOC] has failed miserably, it is of no use if only few
> people use it for few commits.
> Adding to the fact there is almost no activity in the documentations
> we really need to find a better way to organize things.
> Currently we have [DOC], (closed) bug reports, NEWS and wiki all
> overlapping with each other.. not very attractive for newcomers.
>
> Does anyone have any idea how we can organize things better and get
> more people to document?
>
> -Hannes
>


Well,

Not sure how things were around here as I'm kinda new with docs but I might
have something.

I don't how it works internally neither how it works for new documentation.
But I've seen how Ubuntu Launchpad eases the work for translators. Have you
seen it? An online interface is much more attractive than this CVS thing.

Many of us - 'documentors' -  (if not all) are programmers and used to use
CVS and other versioning system. But this takes some extra time that IMHO it
shouldn't. If you want to "spread the word" and get lots of people to help
in docs, I believe this kind of thing that Launchpad uses is a go. I'm very
well aware that this takes time and not every contributor may actually help
with good docs, but it could be moderated.

The quality of the actual docs is awesome, it's one of the best docs I've
ever seen. I don't want to miss that, so I'm all eyes and ears for this
thread.


Regards,
-- 
Thiago Henrique Pojda

------=_Part_84691_5515947.1222870033283--