doc:todo:gitdocs

This is an old revision of the document!


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)
    • Status: TODO
    • 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 (someone with access according to https://wiki.php.net/systems/euk2
    • 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 (Someone with access. Who would that be???)
    • If we have blocked github mirroring during the above, allow it here
      • 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 GitHub 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.1580820741.txt.gz · Last modified: 2020/02/04 12:52 by salathe