docs: publish the site at stratara.tech - #55
Merged
Conversation
There was a problem hiding this comment.
🔵 Needs a closer look
Merge safety depends on an external DNS cutover timing that can’t be validated from the code changes alone.
Pull request overview
This PR migrates the project’s documentation site canonical host from docs.stratara.tech to the apex domain stratara.tech, aligning DocFX configuration and repository references with the GitHub Pages custom-domain setup described in the PR.
Changes:
- Switch GitHub Pages custom domain by updating
docs/CNAMEtostratara.techand updating DocFX_appBaseUrlaccordingly. - Update repository-facing links (root README, support/contributing docs,
llms.txt, issue templates, and sample READMEs) to point athttps://stratara.tech. - Document the DNS/redirect constraint in the docs deployment workflow header comments to prevent accidental removal of the old
docsDNS record.
File summaries
| File | Description |
|---|---|
| SUPPORT.md | Updates the canonical documentation link to https://stratara.tech. |
| samples/Stratara.Sample.TamperProof/README.md | Updates concept-doc link to the new docs host. |
| samples/Stratara.Sample.Encryption/README.md | Updates concept-doc link to the new docs host. |
| README.md | Updates primary documentation links (glossary, getting started, guides, concepts, samples) to https://stratara.tech. |
| llms.txt | Updates “Documentation site” and concept/guide links to https://stratara.tech. |
| docs/legal/privacy.md | Updates front-matter description to reference stratara.tech. |
| docs/docfx.json | Updates DocFX _appBaseUrl to https://stratara.tech for canonical URLs. |
| docs/CNAME | Sets GitHub Pages custom domain to stratara.tech. |
| CONTRIBUTING.md | Updates the “check the docs first” link to https://stratara.tech. |
| .github/workflows/docs.yml | Updates header comment to reflect new published host and keep-old-DNS-record requirement. |
| .github/ISSUE_TEMPLATE/question.md | Updates “checked documentation” checkbox link to https://stratara.tech. |
| .github/ISSUE_TEMPLATE/config.yml | Updates the documentation contact link URL to https://stratara.tech. |
Review details
- Files reviewed: 12/12 changed files
- Comments generated: 0
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Merging this deploys a
CNAMEofstratara.tech. GitHub Pages then makes that the custom domain — and if the apex still resolves to the Plesk server, Pages cannot verify it, the certificate is not issued, and the site is reachable at neither host until DNS catches up. DNS first, merge second.What has to happen at antagus.de
Replace the apex
Arecord forstratara.tech(currently217.154.79.173, the Plesk server) with GitHub's four:Optionally the
AAAArecords as well:2606:50c0:8000::153,8001::153,8002::153,8003::153.Leave the
docsrecord alone.docs.stratara.techmust keep pointing atyesbert.github.io: Pages redirects a previous custom domain to the current one only while that record still resolves to Pages. Deleting it turns every published link — the dev.to articles, the package READMEs already on nuget.org — into a dead end.sonar.stratara.techis a separate record and is untouched.After merging, Pages provisions the certificate; that takes anywhere from a minute to an hour, and Enforce HTTPS may need switching back on once it is issued. The Plesk vhost for
stratara.techthen receives no traffic — worth parking in Plesk so its Let's Encrypt renewals stop failing against a domain it no longer answers for.What this changes
docs/CNAME→stratara.tech, and_appBaseUrlwith it, so canonical URLs follow.README.md,llms.txt,SUPPORT.md,CONTRIBUTING.md, both issue templates and the two hero-sample READMEs.docs.ymlheader now records why the old DNS record has to stay.Two references are deliberately left pointing at the old host: the link in the released
4.0.2changelog entry and the archivedgive-every-reader-their-doorchange. Both are dated records of what was true when written, and the redirect keeps them working.How it was verified
./scripts/local-gauntlet.sh)docfx build --warningsAsErrors— 0 warnings, 0 errors