Document database migration process for schema releases

[Shalsh23]

• Complete documentation for migration process as executed for the most recent migration (v7.7.2 to v7.8.0) @eecavanna
• Links to any previous migration materials
• Decide the best place to live for these and future such documentations

---

@eecavanna on September 29, 2024: New scope of task is in this comment. The above scope is obsolete (although it was accurate when written).

[Shalsh23]

Some relevant links to potentially include in the documentation:

• https://pypi.org/project/nmdc-schema/
• https://github.com/microbiomedata/nmdc-schema/blob/e16b020cd1517fb94a588d82cbf87846766356bb/nmdc_schema/migration_recursion.py#L21-L36
• https://github.com/microbiomedata/nmdc-runtime/tree/main/demo/metadata_migration/from_7_7_2_to_7_8_0

[eecavanna]

Thanks for creating this ticket, @Shalsh23! I'll do item 1 (and I'll do item 2 as part of that). For item 3, I'll eventually create a PR containing the document at some path, which we can change before merging.

[eecavanna]

I expect to finish item 1 this afternoon (Monday).

[ssarrafan]

I'm adding this issue to the sprint board for this sprint. If you're not planning to work on it this or next week let me know.

[eecavanna]

This has been a bit of a moving target, since the procedure being documented underwent some streamlining (changes) during the documentation process. I am still working on it, though.