Migrate a page from the MPC legacy documentation site into docs-public
Migrate a page from the legacy MPC site (minorplanetcenter.net) into the new documentation site (docs-public/docs/mpc-ops-docs/).
Arguments: $ARGUMENTS
Parse $ARGUMENTS to extract:
docs-public/docs/mpc-ops-docs/ (e.g., designations/new-page.md)--target was provided, use that path as the starting proposal.docs-public/docs/mpc-ops-docs/ using Glob.index.md to understand existing organization.observations/timing-requirements.md)Do NOT proceed until the user approves the target location.
Convert the legacy HTML content to clean, MkDocs-compatible markdown following these rules:
!!! note for informational callouts!!! warning for important caveats!!! tip for helpful suggestions!!! danger for critical warnings#, ##, ###).For every link in the content, apply these rules in order:
CLAUDE.md and scan existing files under docs-public/docs/mpc-ops-docs/. If the link target has been migrated, convert to a relative link to the local .md file.minorplanetcenter.net/mpec/...): Keep as absolute URL. Never migrate these.MPNames.html, NumberedMPs.html): Keep as absolute URL. Never migrate these.<!-- TODO: update link when migrated --> after the link.docs-public/docs/mpc-ops-docs/<section>/<filename>.md.index.md for the section with:
<div class="contents-grid"></div> followed by a link list (initially containing just the new page)index.md, create one following the same pattern.index.md.<div class="contents-grid"></div> div.- [Page title](filename.md)## Section Name
<div class="contents-grid"></div>
- [Local page title](local-page.md)
- [Another local page](another-page.md)
- [External service link](https://minorplanetcenter.net/some/service)
.md files under docs-public/docs/ for links pointing to the legacy URL or close variants (with/without trailing slash, with/without www., HTTP vs HTTPS).contents-grid list, it is already correct.docs-public/docs/mpc-ops-docs/index.mddocs-public/docs/mpc-ops-docs/observations.mddocs-public/docs/mpc-ops-docs/orbits.mddocs-public/docs/mpc-ops-docs/astrometry.mddocs-public/docs/mpc-ops-docs/observatory-and-program-codes.mdindex.md files under mpc-ops-docs/CLAUDE.md at the repository root.### Completed Migrations section.- `section/filename.md` - From `/legacy/path`
**section-name/** (migrated from `source-page.md`):
- `section-name/filename.md` - Description - From `/legacy/path`
cd docs-public && mkdocs build --strict 2>&1 | head -50
MIGRATION_TRACKER.md at the repository root.migratedobservations/obs-format.md)redirect-neededLast updated date to todayMIGRATION_TRACKER.md.These rules govern all MPC documentation migrations:
| Rule | Details |
|---|---|
| Button links | <div class="contents-grid"></div> pattern, for locally-hosted pages only |
| Text links | Plain markdown links, for external/dynamic/service pages |
| Never import | MPEC pages, service/API endpoints, auto-generated data lists |
| Subfolder threshold | Create a subfolder with index.md when a topic has 3+ related pages |
| Content location | All migrated pages go under docs-public/docs/mpc-ops-docs/<section>/ |
| No emojis | Never add emojis to documentation content |
| mkdocs-jupyter | Notebooks use execute: false, include_source: true |