Re: Current state of my ideas on moving docs to GIT
| From: | Nikita Popov | Date: | Fri, 01 Feb 2019 13:49:42 +0000 |
| Subject: | Re: Current state of my ideas on moving docs to GIT | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 12 13 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969387149@lists.php.net to get a copy of this message | ||
On Fri, Feb 1, 2019 at 2:43 PM Oliver Albers <olli@3.1415926.org> wrote:
> Hello everyone,
>
> I would like to bump this topic again.
>>
>> Here is the first step that I think needs to happen: Perform a svn2git
>> conversion of the doc-en repo, push it to git@git.php.net:/doc/en.git
>> and setup a cron job to keep it up to date with new changes coming in from
>> SVN.
>>
>> Any takers? I can grant you access to the git repo and can also provide
>> you with an author mapping file for the conversion.
>>
>> The next step would be to do the same for doc-de, while also rewriting
>> SVN revision references.
>>
>> Nikita
>>
>
> I'll maybe be interested int trying to help set it up as I mostly work
> with the French docs.
> However, I don't think I will have the time this weekend.
>
> Also will probably need to look up how to do a svn to git conversion as
> I'm not that familar with SVN as a whole.
>
>
> I do have experience with at least one way synchronisation from SVN to
> git, but really only with that one way. I have not tried to have it work
> from git back to SVN later as well. So I assume that is not what we are
> trying to accomplish, right?
> Also I’not sure that works well with tags and branches, but at least in
> DOC-DE those features are not really used. Do we know of SVN repositories
> that would benefit from synchronising tags and/or branches?
>
> Regards,
> Oliver
>
We only need one way synchronization from svn to git. The way I roughly
expect this to work is that a) we first set up git repos of everything
synced from svn, b) migrate everything that only needs read-only access to
the docs to use the git repos (like doc.php.net) and c) switch to git
exclusively, abandoning the svn repos. For steps a) and b) commits should
only come in from the synchronization with svn, nobody should directly
commit to git. After that commits only go to git. As such, we don't need
synchronization from git to svn.
Regarding tags and branches, as far as I know those are not used by the
docs repositories.
Nikita