Re: Current state of my ideas on moving docs to GIT
| From: | Christoph M. Becker | Date: | Fri, 10 Nov 2017 19:19:39 +0000 |
| Subject: | Re: Current state of my ideas on moving docs to GIT | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386782@lists.php.net to get a copy of this message | ||
On 04.11.2017 at 15:46, Andreas Heigl wrote:
> What did I do so far to investigate ways of moving the PHP-Docs from SVN
> to GIT:
Thanks for your work, Andreas!
> The most important change probably is the revcheck.php-file. As the
> en-repository and the de-repository are now two separate repositories I
> needed to do some git-hacks to get the information about how many
> commits there have been between the translated and the base file. And
> there is definitely room for improvement! I'm looking forward to your ideas!
I'm not sure whether this info is really needed. When going to sync
with EN, I usually check the SVN log of EN, so I quickly get this info.
And frankly, it does not really matter if a translation is a single
commit or many commits behinds; in both cases it is out-dated, and even
a single commit might have more modifications than a lot of commits in
total.
> * How shall we reach a decission on how to go on from here? Is an RFC
> the right approach? Or is there some other form of finding a decission?
That is *the* question! I'm part of the doc team only for a few years,
and during this time only "minor" changes have been made, and these have
been *informally* discussed and decided on this list. Guess, we need
more input from others, especially translators, who might be affected
heavily by this change (e.g. the Brasilian Portuguese team is using a
SVN/Git bridge[1]). Also we have to discuss and decide what happens
with edit.php.net.
[1] <https://github.com/phpdocbrbridge/traducao>
--
Christoph M. Becker