====== TODO - Migrating the PHP documentation from SVN to Git ======


===== Task list =====

Reference: https://news-web.php.net/php.doc/969387429

  - Create language repos for es, fr, it, ja, pl, pt_BR, ro, ru, tr, uk and zh on git.php.net
    * Status: TODO
    * Assigned: Peter
  - Grant force-push access to a user that can push the modified commits from svngit.php.net (can be me, can be a dedicated user)
    * Create a new VCS account for the migration
      * Status: TODO
      * Assigned: Peter
    * Force-push should be allowed by default (AFAIK (Peter) we only restrict force-push to a very small set of branches on a very small number of repos)
      * Status: to be verified
      * Assigned: Peter
  - Add the remotes to the respective repos on svngit.php.net and set up automated force push
    * Status: TODO
    * Assigned: Andreas
  - Switch source-code retrieval on docs.php.net from svn.php.net to git.php.net
    * Clone git repos onto docs box
      * Status: TODO
      * Assigned: (someone with access to euk2)
    * Update build scripts to use git repos
      * Status: TODO
      * Assigned: (anyone, scripts are in systems.git)
  - Switch revcheck-generation from the current script to https://github.com/phpdoctest/doc-base/blob/master/scripts/revcheck.php 
    * Status: TODO
    * Assigned: (anyone, scripts are in doc-base)
  - Verify that everything works as expected (Documentation team. Who would that be? @salathe?)
    * Status: TODO
    * Assigned: Peter
  - Switch source-code retrieval for documentation on rsync.php.net from SVN to git
    * Clone git repos onto rsync box
      * Status: TODO
      * Assigned: Peter
    * Update build scripts to use git repos
      * Status: TODO
      * Assigned: (anyone, scripts are in systems.git)
  - Setup github mirroring and processes to merge merge-requests from github into the documentation git
    * If we have blocked github mirroring in gitolite, allow it now.
      * Status: TODO
      * Assigned: Peter (or anyone with gitolite admin)
    * Otherwise, use the normal setup / procedure as the rest of the git repos (i.e. allow PRs on GH but no-one can merge on GH, merge via git.php.net, use qa.php.net/pulls interface)
  - Rewrite setup-instructions for documentation and send email to docs teams regarding new process
    * Status: TODO
    * Assigned: Andreas and Peter
  - Disallow writing to SVN and allow writing to Git
    * Should just be karma change
      * Status: TODO
      * Assigned: Peter
  - Shutdown cronjobs on svngit.php.net
    * Status: TODO
    * Assigned: Andreas