Skip to content

chore: move documentation from docosaurus to mkdocs#435

Open
RokasBliu wants to merge 2 commits intomainfrom
chore/move-docs-from-docosaurus-to-mkdocs
Open

chore: move documentation from docosaurus to mkdocs#435
RokasBliu wants to merge 2 commits intomainfrom
chore/move-docs-from-docosaurus-to-mkdocs

Conversation

@RokasBliu
Copy link
Copy Markdown
Contributor

Why is this pull request needed?

Many dependabot updates on Docosaurus documentation, so it's about time to move the documentation to mkdocs. This way it will also be possible to add the documentation to Varia.

What does this pull request change?

Moves everything from /documentation (Docosaurus) to /docs (mkdocs).

@RokasBliu RokasBliu force-pushed the chore/move-docs-from-docosaurus-to-mkdocs branch from 3703265 to 57e3755 Compare March 6, 2026 16:05
@RokasBliu RokasBliu force-pushed the chore/move-docs-from-docosaurus-to-mkdocs branch from 97669f1 to d8b1178 Compare March 9, 2026 10:51
@RokasBliu RokasBliu marked this pull request as ready for review March 9, 2026 10:52
@RokasBliu RokasBliu requested a review from a team as a code owner March 9, 2026 10:52
Copy link
Copy Markdown
Contributor

@einarwar einarwar left a comment

Choose a reason for hiding this comment

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

This looks really nice! Tested it locally by running uv run zensical serve and they seem to render nicely

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggestion: I think having this pyproject.toml and corresponding uv.lock thats related to the docs is kinda out of place in the repo root.

Does it break anything if we move it inside the docs directory?

If we do that, the GHA workflows also needs to be updated to point to the correct directory

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggestion: Not really related to this file, but here goes.

Would be nice with a small mention somewhere in the readme on how to build and view docs locally

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I think the pyproject.toml related to docs should also be added here

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