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 features to avoid manually configuring nav: #1698

Closed
Tracked by #1677
butler54 opened this issue Sep 12, 2024 · 2 comments
Closed
Tracked by #1677

Use mkdocs features to avoid manually configuring nav: #1698

butler54 opened this issue Sep 12, 2024 · 2 comments
Labels
documentation Improvements or additions to documentation stale

Comments

@butler54
Copy link
Collaborator

Issue description / feature objectives

Manually configuring nav: for mkdocs is an anti-pattern. It creates inconsistency and removes part of the value of mkdocs - implicit naming based on directory structures.

Rework the automation specifically for the api docs and use mkdocs-awesome-pages to create selective overrides for just what is required.

Caveats / Assumptions

  • Documentation content should not be changed

Completion Criteria

  • nav: is removed
  • content is not changed
@jpower432 jpower432 moved this from New to Ready in Trestle Roadmap Sep 16, 2024
@jpower432 jpower432 added the documentation Improvements or additions to documentation label Sep 16, 2024
Copy link
Contributor

This issue has been automatically marked as stale because it has not had activity within 90 days. It will be automatically closed if no further activity occurs within 30 days.

@github-actions github-actions bot added the stale label Dec 18, 2024
Copy link
Contributor

This issue has been automatically closed due to inactivity.

@github-actions github-actions bot closed this as not planned Won't fix, can't repro, duplicate, stale Feb 12, 2025
@github-project-automation github-project-automation bot moved this from Ready to Done in Trestle Roadmap Feb 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation stale
Projects
Status: Done
Development

No branches or pull requests

2 participants