Re: Github Mirrors of git.php.net/docs

On Sat, Dec 5, 2020 at 6:01 PM Andreas Heigl <[email protected]> wrote:

> Hey folks.
>
> TL;DR
>
> 1. Who can create github mirrors of translations in git?
> 2. Who can review and merge a systems PR and get the changes onto
> euk2.php.net?
> 3. If 1. and 2. result in "no one": Who can grant me access to do that
> and guide me through the process?
>
> Long version:
>
> For some time now we do have the doc-en mirror on github of
> git.php.net:/doc/en.git. People are already happy in contributing via
> PRs to that and therefore to the PHP-Documentation.
>
> Whom do I need to bribe (or simply contact) to get that setup for the
> translations as well? Yes, I know that puts up an extra burden onto the
> docs maintainers by having to backport that to SVN. But as the plan is
> to move the docs from SVN to git anyhow (and rather sooner than later)
> why should the translations not benefit from that? And I'm sure we can
> get some volunteers to take care of the backporting until we have
> finished the transition. I would definitely be one of them.
>
> Besides that the current status of the transition is that the git repos
> are constantly updated from SVN and there's a PR to systems to move the
> creation of the documentation from using SVN as the base to using git as
> the base. Though I fear that the PR is not going to help as the files
> seem to be out of sync and there are already manual changes in the
> touched files. Whom can I contact to get that PR merged and the changes
> put onto the system?
>
> Or, as an option: Who can grant me the necessary rights to do it myself
> and who can guide me through the process of doing so?
>
> Cheers
>
> Andreas
>

Hi Andreas,

I can add mirrors, but intentionally didn't do this for the translation
repos to avoid future issues with force pushes.

I don't think we'll want to use the translation repos in the current form,
because the separate file for tracking EN revisions seems like a really big
PITA for translators. This originally came about due to trouble with
continually rewriting the history to map SVN revisions to Git revisions
while syncing the repos. I think that given how things turned out,
continuous SVN -> Git sync with rewritten history doesn't seem like much of
a priority anymore. I think it would be fine to just do a one-time history
rewrite when we switch, or even just a one-time replacement of revisions in
files (ultimately, the history rewrite is not super important).

As to the systems PR, I can merge that as well, but I don't know about
getting changes on euk2. The wiki says that you have access to that system.
Is that the only system that needs to be updated to build from git? It
sounds like this one is responsible for building docs.php.net, but does it
build the main php.net as well?

Regards,
Nikita