Skip to content

Documentation site at /docs, and URLs for the Folderite rename - #3

Merged
combwizard merged 2 commits into
mainfrom
docs-site
Nov 4, 2026
Merged

combwizard merged 2 commits into
mainfrom
docs-site

Conversation

@combwizard

Copy link
Copy Markdown
Owner

Adds a documentation site at /docs and finishes the repo rename to combwizard/Folderite.

Docs

  • MkDocs Material site built from docs/, with theme overrides in docs-theme/ and docs/stylesheets/extra.css.
  • pages.yml publishes the docs with the landing page. Pull requests that touch the docs run a strict build.
  • Pages follow the system's light or dark mode, like the landing page.
  • site_dir is set in mkdocs.yml because MkDocs' default output is site/, which it empties first, and that folder is the landing page's source here.
  • Screenshots move to docs/images/, and the manual test checklist moves from the README to docs/building.md.
  • CLAUDE.md adds the rule for keeping the docs in step with the code.

Rename

The repo is already renamed on GitHub. This updates the links, badges and site_url to the new name and the new Pages address, https://combwizard.github.io/Folderite/.

  • Merging fixes the preview tags on the live landing page. They still point to the old address, so the preview image is broken.
  • The old address, combwizard.github.io/folderite/, stays a 404. There is no redirect.

Testing

  • mkdocs build --strict passes locally. I last ran it before the final commit, which changes no docs files.
  • After the rename, the deployed landing page and its assets returned 200 at the new address. That deploy was from main, so it doesn't include this branch.
  • Not tested yet: the published docs at /Folderite/docs/, which first deploy when this merges.

MkDocs Material, set up like ZOrbit's: pages in docs/, theme overrides in
docs-theme/ and docs/stylesheets/extra.css, published with the landing page
by pages.yml. Pull requests that touch the docs run a strict build.

Differs from ZOrbit in following the system's light or dark mode, like the
landing page, and in site_dir: MkDocs' default output is site/, which it
empties first, and that is the landing page's source here.

Screenshots move to docs/images/. The manual test checklist moves from the
README to docs/building.md. CLAUDE.md keeps the docs in step with the code.
@combwizard
combwizard merged commit 45d9ce5 into main Nov 4, 2026
8 checks passed
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