Hosted docs are out of date #1550

Closed
opened 2026-03-18 20:50:30 +00:00 by ky-bean · 8 comments

Discovered this while attempting to, ironically, update the docs for another thing I was looking at last night, and as discovered via conversations in the matrix room the hosted docs are out of sync with the docs in the repo. Easily seen via the difference in how to build docs locally:
Hosted version
Repo version

At the end of the hosted page the Last Updated shows 12/28/2025, 12:59:31 AM while the most recent commit to that page within the repo was last week.

Discovered this while attempting to, ironically, update the docs for another thing I was looking at last night, and as discovered via conversations in the matrix room the hosted docs are out of sync with the docs in the repo. Easily seen via the difference in how to build docs locally: [Hosted version](https://continuwuity.org/development/contributing.html#writing-documentation) [Repo version](https://forgejo.ellis.link/continuwuation/continuwuity/src/branch/main/CONTRIBUTING.md#writing-documentation) At the end of the hosted page the Last Updated shows 12/28/2025, 12:59:31 AM while the most recent commit to that page within the repo was last week.
Author

Looking at it I'm not sure that book.toml in the repo root is needed either. AFAIK it was needed for mdbook but since that's not being used any more I'm not sure if the new system is still using it.

Looking at it I'm not sure that `book.toml` in the repo root is needed either. AFAIK it was needed for `mdbook` but since that's not being used any more I'm not sure if the new system is still using it.
Author

There's also some desync between the main contributing doc page (docs/contributing.mdx which is a symlink to the CONTRIBUTING.md file in the repo root) and the one listed under docs/development/contributing.mdx. It looks like the one under docs/development is just an older/out of date version of the one in the repo root, I wonder if it should either be removed or symlinked like the other one.

There's also some desync between the main `contributing ` doc page (`docs/contributing.mdx` which is a symlink to the `CONTRIBUTING.md` file in the repo root) and the one listed under `docs/development/contributing.mdx`. It looks like the one under `docs/development` is just an older/out of date version of the one in the repo root, I wonder if it should either be removed or symlinked like the other one.
Contributor

Contributing.md is #1471.

Contributing.md is #1471.
Contributor

You're right about it being out of date though, thats really odd.

You're right about it being out of date though, thats really odd.
Owner

https://forgejo.ellis.link/continuwuation/continuwuity/actions/runs/12758/jobs/0/attempt/1 - looks like it's not deploying to the main domain for some reason? Cc @morgan

https://forgejo.ellis.link/continuwuation/continuwuity/actions/runs/12758/jobs/0/attempt/1 - looks like it's not deploying to the main domain for some reason? Cc @morgan
Contributor

could be a missing token or something on my runner, but seems unlikely since its able to deploy to a subdomain just fine.

either way, ping me on matrix if you need my input or changes to the runner, I'll pay attention to the issue as well

*could* be a missing token or something on my runner, but seems unlikely since its able to deploy to a subdomain just fine. either way, ping me on matrix if you need my input or changes to the runner, I'll pay attention to the issue as well
Contributor

documentation.yml seems to be working fine nowadays

`documentation.yml` seems to be working fine nowadays
Owner

Yeah

Yeah
Jade closed this issue 2026-04-15 17:38:22 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
5 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
continuwuation/continuwuity#1550
No description provided.