Skip to content

Revert "docs: publish the site at stratara.tech" - #56

Merged
yesbert merged 2 commits into
mainfrom
revert/back-to-the-docs-subdomain
Sep 3, 2026
Merged

Revert "docs: publish the site at stratara.tech"#56
yesbert merged 2 commits into
mainfrom
revert/back-to-the-docs-subdomain

Conversation

@yesbert

@yesbert yesbert commented Sep 3, 2026

Copy link
Copy Markdown
Owner

Why

The apex has to keep pointing at the Plesk server — too much else depends on it. The move is not abandoned, but it will be done by deploying to that server over rsync rather than by moving the domain to GitHub Pages.

What was learned, because it is not obvious

Restoring the Pages custom-domain setting to docs.stratara.tech did not bring the site back: Pages decides which hostname it answers for from the CNAME file in the deployed artifact, not from the repository setting alone. With stratara.tech still in the artifact, docs.stratara.tech kept returning There isn't a GitHub Pages site here. The artifact has to be rebuilt, which is what merging this does.

The mirror image of the same surprise happened on the way out: with the Actions-based deployment, the CNAME file does not set the custom domain either — that was the old branch-publishing behaviour. Both halves have to be done, and in the right order.

What this restores

docs/CNAME, _appBaseUrl and 33 references across README.md, llms.txt, SUPPORT.md, CONTRIBUTING.md, both issue templates and the two hero-sample READMEs.

The local badges from #54 are untouched — this reverts only the domain change.

How it was verified

  • docfx build --warningsAsErrors — 0 warnings, 0 errors
  • docs/CNAME reads docs.stratara.tech; docs/index.md still references the three local badges

The apex has to keep pointing at the Plesk server: too much else depends on it. Pages decides which hostname it answers for from the CNAME file in the deployed artifact, not from the repository setting alone, so restoring the setting was not enough — the artifact had to be rebuilt with the old host. Deployment to that server over rsync comes next.
Copilot AI lite review requested due to automatic review settings September 3, 2026 17:59

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟢 Approval recommended

The changes consistently restore the docs hostname across build artifacts and repository-facing links, with only a minor README badge-text nit noted.

Pull request overview

This PR reverts the documentation site’s published hostname back to docs.stratara.tech (instead of the apex stratara.tech), aligning the DocFX build output, GitHub Pages CNAME, and repository-facing links with the intended DNS setup.

Changes:

  • Restore GitHub Pages custom-domain artifact configuration via docs/CNAME and DocFX _appBaseUrl to docs.stratara.tech.
  • Update repo documentation and templates to link to https://docs.stratara.tech (README, SUPPORT, CONTRIBUTING, issue templates, sample READMEs, llms.txt).
  • Adjust the docs deployment workflow commentary to reflect the restored docs hostname.
File summaries
File Description
SUPPORT.md Updates the canonical docs link to https://docs.stratara.tech.
samples/Stratara.Sample.TamperProof/README.md Updates concept-doc link to the restored docs hostname.
samples/Stratara.Sample.Encryption/README.md Updates concept-doc link to the restored docs hostname.
README.md Updates multiple documentation links to https://docs.stratara.tech.
llms.txt Updates “authoritative reference” links to https://docs.stratara.tech.
docs/legal/privacy.md Updates frontmatter description to reference docs.stratara.tech.
docs/docfx.json Restores _appBaseUrl to https://docs.stratara.tech.
docs/CNAME Restores the Pages custom-domain CNAME value to docs.stratara.tech.
CONTRIBUTING.md Updates “check docs first” link to https://docs.stratara.tech.
.github/workflows/docs.yml Updates workflow header comment to reflect the restored docs hostname.
.github/ISSUE_TEMPLATE/question.md Updates pre-flight checklist to point at https://docs.stratara.tech.
.github/ISSUE_TEMPLATE/config.yml Updates “Stratara documentation” contact link to https://docs.stratara.tech.
Review details
  • Files reviewed: 12/12 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread README.md Outdated
@yesbert
yesbert merged commit 9414fb3 into main Sep 3, 2026
5 checks passed
@yesbert
yesbert deleted the revert/back-to-the-docs-subdomain branch September 3, 2026 18:06
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.

2 participants