Re: Moving documentation to git
| From: | Ben Ramsey | Date: | Wed, 14 Jun 2017 16:25:11 +0000 |
| Subject: | Re: Moving documentation to git | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386628@lists.php.net to get a copy of this message | ||
> On Jun 14, 2017, at 11:13 AM, Andreas Heigl <andreas@heigl.org> wrote:
>
> Hi Oliver
>
>> Am 14.06.2017 um 17:51 schrieb Oliver Albers <olli@3.1415926.org>:
>>
>> 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.
> Thank you for mentioning that as I wasn't aware of it! Do you (or anyone else) know
> whether there is a list of such systems?
>
> Without having dug deeper into it (which I surely will do) there should be a way of doing that
> using
>
> * keyword-substitution via gitattributes in combination with git archive or
> * calls to dedicated scripts that gather data directly from a git-repo or
> * static files created during an automated build on a CI-System
>
> Those are only first ideas and I will definitely have a look what is beeded and possible. And
> please, if you (or anyone else) has further ideas, please let me know.
Maybe it would be worth putting together a proof-of-concept? Have you
read through https://wiki.php.net/doc/git yet? I know
that's old, but
it might be a good starting point, especially the "Proposed Git
Structure" section.
-Ben
Attachment: [application/pgp-signature] Message signed with OpenPGP using GPGMail signature.asc
Attachment: [application/pgp-signature] Message signed with OpenPGP using GPGMail signature.asc