Skip to content

docs: record the publication of the four documentation areas - #2

Merged
koenvanexem merged 1 commit into
mainfrom
docs/areas-published
Oct 19, 2026
Merged

koenvanexem merged 1 commit into
mainfrom
docs/areas-published

Conversation

@koenvanexem

Copy link
Copy Markdown
Member

The four documentation areas are published beneath the home: Allors3 at /allors3/, Documents at
/documents/, Excel at /excel/ and Immersive at /immersive/, each from its own repository by
its own Documentation workflow, after the pull requests allors/allors3#286, allors/documents#11,
allors/excel#28 and allors/immersive#2 switched their deployment origin to
https://docs.allors.com and gave each sidebar a first entry back to the home. The decision record
becomes Current: its status line, scope and Free-plan sentences describe the published state, the
publication steps are recorded as taken on 2026-10-19, with the areas' step completed, and a
paragraph says that the custom domain of the organisation site applies to every project site, so
that an area needs no domain configuration of its own, and that HTTPS is enforced on the domain.
The website instructions describe the published state in the same way. The index is unchanged; its
links into the areas now resolve.

Validation on 2026-10-19, after the four areas were published: at https://docs.allors.com, the
home and every area answer 200 for their page, index.md and llms.txt; http:// addresses
redirect to https://; https://allors.github.io/ and https://allors.github.io/<area>/ redirect
to the domain; a browser walks home → area → home for the four areas through the sidebar links
without page errors; the published output names nothing outside the public scope. At the
repository root: npm test, npm run check, npm run build, npm run check:links and
npm run test:browser; the Documentation workflow validates this pull request.

The four documentation areas are published beneath the home: Allors3 at `/allors3/`, Documents at
`/documents/`, Excel at `/excel/` and Immersive at `/immersive/`, each from its own repository by
its own Documentation workflow, after the pull requests allors/allors3#286, allors/documents#11,
allors/excel#28 and allors/immersive#2 switched their deployment origin to
`https://docs.allors.com` and gave each sidebar a first entry back to the home. The decision record
becomes Current: its status line, scope and Free-plan sentences describe the published state, the
publication steps are recorded as taken on 2026-10-19, with the areas' step completed, and a
paragraph says that the custom domain of the organisation site applies to every project site, so
that an area needs no domain configuration of its own, and that HTTPS is enforced on the domain.
The website instructions describe the published state in the same way. The index is unchanged; its
links into the areas now resolve.

Validation on 2026-10-19, after the four areas were published: at `https://docs.allors.com`, the
home and every area answer 200 for their page, `index.md` and `llms.txt`; `http://` addresses
redirect to `https://`; `https://allors.github.io/` and `https://allors.github.io/<area>/` redirect
to the domain; a browser walks home → area → home for the four areas through the sidebar links
without page errors; the published output names nothing outside the public scope. At the
repository root: `npm test`, `npm run check`, `npm run build`, `npm run check:links` and
`npm run test:browser`; the Documentation workflow validates this pull request.
@koenvanexem
koenvanexem merged commit afe47b2 into main Oct 19, 2026
4 checks passed
@koenvanexem
koenvanexem deleted the docs/areas-published branch October 19, 2026 16:51
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