[PHP-DEV] Re: Github Mirrors of git.php.net/docs

Andreas Heigl <[email protected]> Tue, 29 Dec 2020 11:35:48 +0100
Newsgroups	gmane.comp.php.devel,gmane.comp.php.documentation.general
Message-ID	<[email protected]>
Hey Lists, hey Nikita.

Just to give some feedback.

Am 27.12.20 um 14:59 schrieb Nikita Popov:
> On Sun, Dec 27, 2020 at 11:30 AM Andreas Heigl <[email protected]
> <mailto:[email protected]>> wrote:
> 
[...]
> I don't think fixing revcheck in advance is particularly important, I
> just want to retain the current format of EN-Revisions stored in each
> file (just with git hashes instead of SVN revisions).
> 
> Basically, I want to run this script after writes to SVN have been
> disabled and before writes to Git are enabled:
> https://gist.github.com/nikic/8ee88a817db794aff15adb7e07754e23 It just
> moves the hashes back into EN-Revision and drops the .en-revisions.ref
> file. It does need something like 20 minutes per repo, but it's a
> one-time cost.
> 
> Does that sound reasonable to you? Basically, the plan would be:
> 1. Remove phpdoc SVN karma from everyone. (me)
> 2. Disable SVN -> Git mirroring. (you)
> 3. Run above script to move hashes back into EN-Revision and force push
> repos. (you or me)
> 4. Add Git karma for everyone. (me)
> 5. Set up GitHub mirrors (me)
> And I think this is something we could do anytime now, if I understood
> your right that the online docs are *already* being built from Git.

After Nikitas merge I transfered the changes to the euk2-box and since
the 27th of December 2020 16:30H UTC the PHP-documentation is building
from git instead of SVN.

So we are prepared to take the next step now.

@Nikita: I would like to add a step 0 to the plan which would be to
inform the docs-contributors via the docs-mailinglist about the changes
and especially about date and time of the change so that they can adapt
their local settings in advance. Feel free to drop me a direct email re.
Date and Time

Additionally I just realized that the link on each docs-page to "edit"
is linking to edit.php.net which we should then change after the move to
link to the appropriate github-repo.

Cheers

Andreas
-- 
                                                              ,,,
                                                             (o o)
+---------------------------------------------------------ooO-(_)-Ooo-+
| Andreas Heigl                                                       |
| mailto:[email protected]                  N 50°22'59.5" E 08°23'58" |
| https://andreas.heigl.org                                           |
+---------------------------------------------------------------------+
| https://hei.gl/appointmentwithandreas                               |
+---------------------------------------------------------------------+
signature.asc (application/pgp-signature, 833 B)