Skip to content

docs: describe shared pages usage in Docs Distribution Release Process - #37

Open
AJedancov wants to merge 3 commits into
rollingfrom
docs/describe-shared-pages-usage
Open

docs: describe shared pages usage in Docs Distribution Release Process#37
AJedancov wants to merge 3 commits into
rollingfrom
docs/describe-shared-pages-usage

Conversation

@AJedancov

Copy link
Copy Markdown
Collaborator

Basic Info

Info Please fill out this column
Ticket(s) this addresses #36
Does this PR contain AI-generated software? No

Description of contribution in a few bullet points

Added steps required to synchronize shared pages against the Rolling branch.

Signed-off-by: AJedancov <andrei.jedancov@gmail.com>
Comment thread docs/community/maintainer_docs/docs_release.md Outdated
Signed-off-by: AJedancov <andrei.jedancov@gmail.com>
Signed-off-by: AJedancov <andrei.jedancov@gmail.com>
@AJedancov
AJedancov force-pushed the docs/describe-shared-pages-usage branch from 177bf2b to dd32409 Compare August 11, 2026 13:12
Comment on lines +117 to +141
- Home:
# The Home page displays the first two levels of the navigation structure
# with manually specified links to each page for quick access.
# Update this section whenever the documentation directory structure or page order changes.
- index.md
- Getting Started:
- getting_started/index.md
- Quickstart: getting_started/quickstart/quickstart.md
- Build and Install: getting_started/build_and_install/index.md
- Dev Container: getting_started/dev_container/index.md
- Navigation Concepts: getting_started/navigation_concepts/index.md
- Nav2 Behavior Trees: getting_started/nav2_behavior_trees/index.md
- Tutorials:
- tutorials/index.md
- Plugin Tutorials: tutorials/plugin_tutorials/index.md
- General Tutorials: tutorials/general_tutorials/index.md
- Configuration & Development:
- configuration_and_development/index.md
- First-Time Robot Setup Guide: configuration_and_development/first_time_robot_setup_guide/index.md
- Navigation Plugins: configuration_and_development/navigation_plugins.md
- Configuration Guide: configuration_and_development/configuration_guide/index.md
- Tuning Guide: configuration_and_development/tuning_guide.md
- Simple Commander API: configuration_and_development/simple_commander_api/simple_commander_api.md
- Migration Guides: configuration_and_development/migration_guides/index.md
- API Docs: https://api.nav2.org/

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
- Home:
# The Home page displays the first two levels of the navigation structure
# with manually specified links to each page for quick access.
# Update this section whenever the documentation directory structure or page order changes.
- index.md
- Getting Started:
- getting_started/index.md
- Quickstart: getting_started/quickstart/quickstart.md
- Build and Install: getting_started/build_and_install/index.md
- Dev Container: getting_started/dev_container/index.md
- Navigation Concepts: getting_started/navigation_concepts/index.md
- Nav2 Behavior Trees: getting_started/nav2_behavior_trees/index.md
- Tutorials:
- tutorials/index.md
- Plugin Tutorials: tutorials/plugin_tutorials/index.md
- General Tutorials: tutorials/general_tutorials/index.md
- Configuration & Development:
- configuration_and_development/index.md
- First-Time Robot Setup Guide: configuration_and_development/first_time_robot_setup_guide/index.md
- Navigation Plugins: configuration_and_development/navigation_plugins.md
- Configuration Guide: configuration_and_development/configuration_guide/index.md
- Tuning Guide: configuration_and_development/tuning_guide.md
- Simple Commander API: configuration_and_development/simple_commander_api/simple_commander_api.md
- Migration Guides: configuration_and_development/migration_guides/index.md
- API Docs: https://api.nav2.org/
# ... Main website ...

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I'm working on an approach that doesn't require changes to the .nav config. I'd like to keep this PR unchanged while complete the testing.

Comment on lines +154 to +156
- Getting Started: getting_started
- Tutorials: tutorials
- Configuration & Development: configuration_and_development

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Aren't these before the Community/Robots Using/About & Contact?

If so, remove as well

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I just wanted the full list of the shared docs pages

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