Skip to content

docs: move the documentation site to implementation.opensysml.org - #797

Merged
HuiJun merged 2 commits into
developfrom
docs/implementation-subdomain
Oct 2, 2026
Merged

HuiJun merged 2 commits into
developfrom
docs/implementation-subdomain

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

What and why

The opensysml.org apex domain becomes the OpenSysML ecosystem landing page, published from Open-MBEE/opensysml.github.io (Open-MBEE/opensysml.github.io#1). The documentation site moves to implementation.opensysml.org:

  • mkdocs.yml site_url → https://implementation.opensysml.org/ (canonical links, sitemap)
  • New docs/CNAME → implementation.opensysml.org, so the Pages artifact claims the subdomain on deploy and releases the apex
  • Every link to the published site repointed: README badge and docs link, CONTRIBUTING, the three issue templates, the nightly release notes message, spec-compliance.md, and the header menu, which also gains a link back to opensysml.org

SysML model URIs like attribute redefines target = "https://opensysml.org/" in the manual examples are model data, not site links, and are unchanged.

How it was verified

  • python -m mkdocs build --strict passes; site/CNAME and the canonical URL in site/index.html confirm the new domain
  • python3 scripts/check-doc-links.py and python3 scripts/changelog.py check pass

Checklist

  • make test and make lint pass locally (docs-only change: mkdocs build --strict, link and changelog checks run instead)
  • Tests added or updated for the change (n/a — site configuration)
  • Documentation extended where it already covers the surface (see CONTRIBUTING.md)
  • Changelog entry added as changes/unreleased/<slug>.<section>.md, not as an edit to CHANGELOG.md
  • baselines regenerated and make docs-counts run if a gate count moved (no gate counts moved)
  • No internal work-item labels (waves, slices, F4, K5) in the body, docs, or changelog

Link to Devin session: https://nasa-jpl-demo.devinenterprise.com/sessions/39fe31b6ac564016859146b2f1761a6a
Open in Devin Desktop: https://nasa-jpl-demo.devinenterprise.com/desktop/session/39fe31b6ac564016859146b2f1761a6a?variant=devin
Requested by: @HuiJun

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

I'll fix CI failures and address comments from users with write access. I'll skip comments containing "(aside)".

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration
devin-ai-integration Bot marked this pull request as ready for review October 1, 2026 21:20

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔍 Devin Review: 1 flag

Not posted on this PR by your GitHub settings — view it in Devin Review. (Configure)

Devin Review

The opensysml.org apex domain becomes the OpenSysML ecosystem landing
page, published from Open-MBEE/opensysml.github.io. site_url, the Pages
CNAME, and every link to the published site move to the new subdomain;
the header menu gains a link back to the landing page.

Co-Authored-By: jason.han <hanhuijun@gmail.com>
@devin-ai-integration
devin-ai-integration Bot force-pushed the docs/implementation-subdomain branch from cca6b66 to 2c65281 Compare October 2, 2026 01:48
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

Note on the failing Go race tests (rest) check: tests/migrate fails on TestInstantBehaviorsWaitingForTheClockAreLedgered and TestGoldenConstructFixtures/instant_waits, both against testdata/xmi/instant_waits.golden.sysml. The same failures reproduce on a clean checkout of origin/develop (9365f43), so this is a preexisting develop issue unrelated to this docs-only diff — fix/instant-waits-golden is already in flight upstream. Build and test fails only as the aggregate gate over that check. I'll rebase onto develop once the golden fix lands.

docs/internals/performance.md measures 0.27 s; the landing page still
quoted the older 0.43 s figure in the hero meta and the numbers strip.

Co-Authored-By: jason.han <hanhuijun@gmail.com>
@HuiJun
HuiJun merged commit aa331d4 into develop Oct 2, 2026
24 checks passed
@HuiJun
HuiJun deleted the docs/implementation-subdomain branch October 2, 2026 15:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant