Re: Moving documentation to git
| From: | Andreas Heigl | Date: | Wed, 14 Jun 2017 20:42:05 +0000 |
| Subject: | Re: Moving documentation to git | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386633@lists.php.net to get a copy of this message | ||
Am 14.06.17 um 22:33 schrieb André L F S Bacci:
> On Wed, Jun 14, 2017 at 12:51 PM, Oliver Albers <olli@3.1415926.org> wrote:
>
>> Hello Andreas,
>>
>> the git idea has been floating around for a while. The problem with it is
>> that the translation process for the documentation is very much using
>> automatic svn keyword substitution for the file’s revision to check if a
>> version of the translation is up to date or not (see
>> http://doc.php.net/revcheck.php for example). In my opinion
>> there needs
>> to be a workaround for that.
>
>
> For this, I suggest not trying to save the revision id inside the english
> file
The only keyword used seems to be *Revision* which definitely can be
worked around using the following approach.
All other keywords (Id, Date, Author, File, Source) are not used at all
(https://github.com/phpdoctest/meta/wiki/SVN_Keywords)
>
> Something like this:
>
> 1. In en/, in each directory, use `git log -n 1 --pretty=format:%H --
> file.xml` to obtain the last commit hash of each file, and generate a
> local, ignored .git.hashs file.
>
> 2. In translations, the id in revision tags is now the last commit hash.
>
> 3. In tools, now it's compare the two ids to see what files need
> translations and to generate diffs (from revision tag hash to .git.hashs
> hash).
>
Good Idea André. I might ping you on that again…
Cheers
Andreas
--
,,,
(o o)
+---------------------------------------------------------ooO-(_)-Ooo-+
| Andreas Heigl |
| mailto:andreas@heigl.org N
50°22'59.5" E 08°23'58" |
| http://andreas.heigl.org http://hei.gl/wiFKy7 |
+---------------------------------------------------------------------+
| http://hei.gl/root-ca
|
+---------------------------------------------------------------------+
Attachment: [application/pgp-signature] OpenPGP digital signature signature.asc
Attachment: [application/pgp-signature] OpenPGP digital signature signature.asc