doc:todo:gitdocs

TODO - Migrating the PHP documentation from SVN to Git

Task list

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

  1. 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
  2. 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
  3. Add the remotes to the respective repos on svngit.php.net and set up automated force push
    • Status: TODO
    • Assigned: Andreas
  4. 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)
  5. 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)
  6. Verify that everything works as expected (Documentation team. Who would that be? @salathe?)
    • Status: TODO
    • Assigned: Peter
  7. 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)
  8. 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)
  9. Rewrite setup-instructions for documentation and send email to docs teams regarding new process
    • Status: TODO
    • Assigned: Andreas and Peter
  10. Disallow writing to SVN and allow writing to Git
    • Should just be karma change
      • Status: TODO
      • Assigned: Peter
  11. Shutdown cronjobs on svngit.php.net
    • Status: TODO
    • Assigned: Andreas
doc/todo/gitdocs.txt · Last modified: 2020/02/04 12:56 by salathe