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

docs(planning): update documentation structure #5694

Merged

Conversation

zulfaqar-azmi-t4
Copy link
Contributor

@zulfaqar-azmi-t4 zulfaqar-azmi-t4 commented Nov 27, 2023

Description

Navigating the planning module documentation is quite challenging because the current document's hierarchical structure is based on the alphabetical order of folders, and on whether a docs folder exists in the module's folder.

The behavior path planner and behavior velocity planner are particularly affected, which might cause confusion for users about which document they should view first to understand the planning modules.

This PR aims to resolve this issue by manually specifying the order of the documents.

Tests performed

Not applicable.

Effects on system behavior

Not applicable.

Pre-review checklist for the PR author

The PR author must check the checkboxes below when creating the PR.

In-review checklist for the PR reviewers

The PR reviewers must check the checkboxes below before approval.

Post-review checklist for the PR author

The PR author must check the checkboxes below before merging.

  • There are no open discussions or they are tracked via tickets.

After all checkboxes are checked, anyone who has write access can merge the PR.

@zulfaqar-azmi-t4 zulfaqar-azmi-t4 added type:documentation Creating or refining documentation. (auto-assigned) run:deploy-docs Mark for deploy-docs action generation. (used-by-ci) labels Nov 27, 2023
@github-actions github-actions bot removed the type:documentation Creating or refining documentation. (auto-assigned) label Nov 27, 2023
Copy link

github-actions bot commented Nov 27, 2023

@zulfaqar-azmi-t4 zulfaqar-azmi-t4 force-pushed the documentation-index branch 2 times, most recently from 482efca to 2ac083b Compare November 28, 2023 02:10
@zulfaqar-azmi-t4 zulfaqar-azmi-t4 changed the title docs: documentation index docs(planning): update documentation structure Nov 28, 2023
@zulfaqar-azmi-t4 zulfaqar-azmi-t4 added the run:build-and-test-differential Mark to enable build-and-test-differential workflow. (used-by-ci) label Nov 28, 2023
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
@zulfaqar-azmi-t4 zulfaqar-azmi-t4 marked this pull request as ready for review November 28, 2023 06:18
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
@github-actions github-actions bot added type:documentation Creating or refining documentation. (auto-assigned) component:planning Route planning, decision-making, and navigation. (auto-assigned) labels Nov 28, 2023
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
zulfaqar-azmi-t4 and others added 2 commits December 4, 2023 13:59
Co-authored-by: Takamasa Horibe <[email protected]>
Co-authored-by: Takamasa Horibe <[email protected]>
@TakaHoribe TakaHoribe self-requested a review December 4, 2023 05:02
Copy link
Contributor

@TakaHoribe TakaHoribe left a comment

Choose a reason for hiding this comment

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

LGTM

@zulfaqar-azmi-t4 zulfaqar-azmi-t4 merged commit 9ff2cd5 into autowarefoundation:main Dec 4, 2023
@zulfaqar-azmi-t4 zulfaqar-azmi-t4 deleted the documentation-index branch December 4, 2023 09:47
kyoichi-sugahara pushed a commit to kyoichi-sugahara/autoware.universe that referenced this pull request Dec 5, 2023
* docs(planning): update documentation structure

Signed-off-by: Zulfaqar Azmi <[email protected]>

* fix typo

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* move sampling based planner to motion planning

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* try with link

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning folder on top

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning at top page

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

---------

Signed-off-by: Zulfaqar Azmi <[email protected]>
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
danielsanchezaran pushed a commit to tier4/autoware.universe that referenced this pull request Dec 15, 2023
* docs(planning): update documentation structure

Signed-off-by: Zulfaqar Azmi <[email protected]>

* fix typo

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* move sampling based planner to motion planning

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* try with link

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning folder on top

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning at top page

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

---------

Signed-off-by: Zulfaqar Azmi <[email protected]>
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
karishma1911 pushed a commit to Interplai/autoware.universe that referenced this pull request Jun 3, 2024
* docs(planning): update documentation structure

Signed-off-by: Zulfaqar Azmi <[email protected]>

* fix typo

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* move sampling based planner to motion planning

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* try with link

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning folder on top

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

* planning at top page

Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>

---------

Signed-off-by: Zulfaqar Azmi <[email protected]>
Signed-off-by: Muhammad Zulfaqar Azmi <[email protected]>
Signed-off-by: karishma <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:planning Route planning, decision-making, and navigation. (auto-assigned) run:build-and-test-differential Mark to enable build-and-test-differential workflow. (used-by-ci) run:deploy-docs Mark for deploy-docs action generation. (used-by-ci) type:documentation Creating or refining documentation. (auto-assigned)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants