Skip to content

Try to do some improvements in the docs. #137

Open
radnvlad wants to merge 2 commits intotock:masterfrom
radnvlad:feature/docs_improvements
Open

Try to do some improvements in the docs. #137
radnvlad wants to merge 2 commits intotock:masterfrom
radnvlad:feature/docs_improvements

Conversation

@radnvlad
Copy link

@radnvlad radnvlad commented Feb 25, 2026

Mkdocs apparently changed the pages key to nav key. At least the latest version I used to build. Without the new key, I could not build. I did not attempt using al older version, but you probably would use to build the latest version.

Added some more info on how to build the documentation saying to do this in the venv. On ubuntu at least the environment is manged by the OS, so you can't install without some amount or risk and the console yelling at you. Probably the location I added this is not optimal, but I'm open to suggestions.

Added the .venv to gitignore.

The .md file are build artefacts. They probably should not be checked in the repo at all. So I removed them. And ignored them at the docs folder level.

Mkdocs apparently change the pages key to nav key. At least the latest version I got would revuse to build.

Added some more info on how to build the documentation kind of suggesting we do this in the venv. On ubuntu at least the environment is manged by the OS, so you can't install without some amount or risk an the console yelling at you. Probably the location I added this is not optimal, but I'm open to suggestions.

Added the .venv to gitignore.
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