Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use mkdocs for public documentation #2527

Merged
merged 6 commits into from
Jul 1, 2024
Merged

Conversation

MattHag
Copy link
Collaborator

@MattHag MattHag commented Jun 13, 2024

Build a better documentation with navigation that shows all pages, a search and includes developer documentation from Python code.

Fixes #2502, #2503

@MattHag MattHag force-pushed the create_mkdocs branch 2 times, most recently from ac170a5 to d834b7c Compare June 13, 2024 23:34
@pfps
Copy link
Collaborator

pfps commented Jun 29, 2024

How can this be tested before merging?

@MattHag
Copy link
Collaborator Author

MattHag commented Jun 29, 2024

The resulting docs should be visible on my branch and could also be downloadable as artifact.

@pfps
Copy link
Collaborator

pfps commented Jun 29, 2024

Where is the analogue of https://pwr-solaar.github.io/Sofixlaar/capabilities

Build and debug docs locally:
mkdocs serve
@MattHag
Copy link
Collaborator Author

MattHag commented Jun 30, 2024

Here they are
https://matthag.github.io/Solaar/

@pfps pfps merged commit 59b3070 into pwr-Solaar:master Jul 1, 2024
5 checks passed
@MattHag MattHag deleted the create_mkdocs branch September 25, 2024 20:05
@MattHag
Copy link
Collaborator Author

MattHag commented Nov 19, 2024

There are still some deployments via GitHub Actions triggered with a wrong theme, which overwrites the public Solaar documentation.

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.

Docs: Switch theme to enable page navigation and search
2 participants