HG migration

HG migration notes

stuff that's here:

usage - intended usage of Mercurial after migration
path - the migration path
todo - preliminary partial todo list