CONTRIBUTING: https://github.com/babel/phabricator-to-github/blob/master/CONTRIBUTING.md

Just an issue to track what we can/should do to migrate

Info

Old issue id range: 1 - 3086 (maniphest_task)
New issue range: > 6637
Number of new issues: ~871
Number of new comments: ~2940
Github ratelimit is 5000 requests/hour (https://developer.github.com/v3/#rate-limiting)

Open questions:

• How to compare/merge issues? Someone needs to check if the github id is somewhere in the phabricator dump. Otherwise we need to retrieve all comments beforehand. Phabricator ids match the github ids.
• What was the last phabricatorID for the import from github? IF we know that we can easily know which to merge and which to create (3086)
• Do we want to migrate issues that do not exist yet in github but are already closed? YES
• Do we need to migrate attachments? (There are 41 attachments that can be migrated by hand)
• The issue import API is async, which means that issues could get imported in random order. We could wait till the import of one issue is finished and then send the next, but then the import might take several hours (I've seen delays of up to a minute between sending request and issue being imported.)

Tasks:

• phabricator db dump -> more consumable format Import mysql dump into sqlite to be easy consumable #1
• script to create a new github issue with the issues api
• script to create all the comments for this new issues.
• script to merge existing issues that had more comments, changes, ...
• script to close finished issues
• handle the edge case that someone really posts an issue during migration and log these issue numbers (should be easy by just looking if the returned issue number from the api is +1 the last issue number), otherwise they might get lost in the flood of issues.
• create a new dummy user that will actually "report" all the migrated stuff in github (maybe babel-bot)
• setup a simple issue/pr template in the babel repo Issue and PR templates babel#3690
• Move parser issues to babylon. (16 Issues, https://phabricator.babeljs.io/maniphest/query/5cfBx2lNVIJt/#R)

• We don't want to spam watchers on github with notifications.
  • Maybe notify all watchers of babel at what time we will do the migration, so they could unwatch the project for that period.
  • Or maybe we can globally disable notifications?
  • Or contact github about that? Maybe also useful for the api rate limiting
• make sure usernames transfer over correctly
  • some people don't sign up with github (can we link everything?)
  • is it possible to transfer subscribers?