Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969384458 php.internals:67796
Return-Path: <tyra3l@gmail.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 76530 invoked from network); 25 Jun 2013 08:42:23 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 25 Jun 2013 08:42:23 -0000
Authentication-Results: pb1.pair.com header.from=tyra3l@gmail.com; sender-id=pass
Authentication-Results: pb1.pair.com smtp.mail=tyra3l@gmail.com; spf=pass; sender-id=pass
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.223.182 as permitted sender)
X-PHP-List-Original-Sender: tyra3l@gmail.com
X-Host-Fingerprint: 209.85.223.182 mail-ie0-f182.google.com  
Received: from [209.85.223.182] ([209.85.223.182:49684] helo=mail-ie0-f182.google.com)
	by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP
	id F2/D5-49518-CE759C15 for <phpdoc@lists.php.net>; Tue, 25 Jun 2013 04:42:20 -0400
Received: by mail-ie0-f182.google.com with SMTP id s9so27330812iec.13
        for <multiple recipients>; Tue, 25 Jun 2013 01:42:17 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :cc:content-type;
        bh=U/sNyqy1A/QOXC9shu4bJQTlI06NiqP0iMShO/KuXB8=;
        b=BDQC9d+tZFf3ieQ81naYqDvHwx637ZEwsWgFu2PEGfRjisivjAu6XmrcLojP8P1Q5s
         9mp8qD/DQBI2NBGeNd1qwTlty/p3oE5cymh6B/2A6wKb0qEZhAx9DgMpKx6eyBQa9Vwe
         EZdibJYs79pMqK2RnTKEgI5k9o+4gp4nNjcMHSGoK9OZ07hh0WMCzzQmTFz8R1XhUF+p
         8jtp3ohJhuJRHsAfh9FfXKhRBcdPY8A7egLh9v84pjjiTWFhf/9NoagJ0b33mCcE22xg
         dDPC0g40wnxBBlTpR+JhWFv2qFinn9eKliuU5RknJh9sco4uktA083hcf9Ya3nYGrVtZ
         MB7Q==
MIME-Version: 1.0
X-Received: by 10.50.176.228 with SMTP id cl4mr7839681igc.7.1372149737347;
 Tue, 25 Jun 2013 01:42:17 -0700 (PDT)
Received: by 10.50.65.8 with HTTP; Tue, 25 Jun 2013 01:42:17 -0700 (PDT)
In-Reply-To: <CAEZPtU6HN=e2YTq5CzMS_+Q8d2JSz+OgLSQZSp0ZSEM_-s8jbw@mail.gmail.com>
References: <4ED7146272E04A47B986ED49E771E347BB4DF6F231@Ikarus.ameusgmbh.intern>
	<51C94A8A.1040800@2bepublished.at>
	<CAEZPtU6Y6NqhnwCR-1UYQmLam+MHhFnC28PJ2+E5E8Fd8k6RmQ@mail.gmail.com>
	<CAEZPtU6HN=e2YTq5CzMS_+Q8d2JSz+OgLSQZSp0ZSEM_-s8jbw@mail.gmail.com>
Date: Tue, 25 Jun 2013 10:42:17 +0200
Message-ID: <CAH-PCH5Fvf2Py1aLBKC5eN-jsZWMtQEf4HMOe9kZMuXpOdPR3g@mail.gmail.com>
To: Pierre Joye <pierre.php@gmail.com>
Cc: Christoph Rosse <crosse@2bepublished.at>, phpdoc <phpdoc@lists.php.net>, 
	PHP internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=089e0111d7eeac645404dff681e1
Subject: Re: [PHP-DEV] Moving PHP documentation to Git repository
From: tyra3l@gmail.com (Ferenc Kovacs)

--089e0111d7eeac645404dff681e1
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Tue, Jun 25, 2013 at 10:18 AM, Pierre Joye <pierre.php@gmail.com> wrote:
> > On Tue, Jun 25, 2013 at 9:45 AM, Christoph Rosse <crosse@2bepublished.a=
t>
> wrote:
> >> On 25.06.2013 08:46, Christian Stoller wrote:
> >>>
> >>> Hi internals.
> >>>
> >>> What do you think about moving the PHP documentation to a Git
> repository,
> >>> mirrored on Github? Doing this would make it possible for everybody t=
o
> >>> extend the documentation easily by creating pull requests.
> >>>
> >>> Today one has to get an SVN account to edit the docu or you have to u=
se
> >>> https://edit.php.net/ which does not work as expected (at least for
> me when
> >>> I tried to update some German documentation). My changes have not bee=
n
> >>> integrated for some months (I had to write an email to somebody of th=
e
> doc
> >>> team to apply the changes).
> >>>
> >>> Symfony does it this way (see https://github.com/symfony/symfony-docs=
/
> )
> >>> and I like it very much. It is really easy to extend/update parts of
> the
> >>> docu which are not complete or outdated and I am sure that it is
> comfortable
> >>> and timesaving for the doc team, too.
> >>>
> >>> What do you think?
> >>>
> >>> Best regards
> >>> Christian
> >>>
> >>
> >> As one who's had very similar experiences when trying to update some
> >> documentation via. edit.php.net (no feedback, no integration etc.) I
> would
> >> really love to see this feature.
> >
> > Really? That's not too good as we have been promoted this tool for
> > some time already.
> >
> > However adding the php-doc list to CC so they can answer and give us
> > some feedback/info.
> >
> > Cheers,
> > --
> > Pierre
> >
> > @pierrejoye |  http://www.libgd.org
>

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).

--=20
Ferenc Kov=C3=A1cs
@Tyr43l - http://tyrael.hu

--089e0111d7eeac645404dff681e1--