[Autoware Documentation] Installation section architecture

[shmpwk]

In the Installation page of Autoware Documentation, there are "Tools for users" and "Tools for developers".
They might mislead readers since the contents are not actually Tools.
So I suggest changing the name of the pages.

Possible alternative name is as follows:

• Additional settings (setups)
• Recommended post-installation steps
• Optional setups (configuration)

Also, it would be better to separate User/Developer page as it is.

Any other ideas? I will create PR after this discussion settles down.

[mitsudome-r]

@shmpwk Thanks for raising the issue. I think your points are valid. We can still keep the pages for "Tools" and create a new page for additional configuration.

[shmpwk]

Thank you for your reply.
You mean the current contents in "Tools for users/ developers" should move to additianal configuration pages and the pages "Tools for users/ developers" should be written like "Under Construction"?

[Edited]
Now I understand what you want to say. I create PR which leaves Tools page and adds additional configuration page.
autowarefoundation/autoware-documentation#104

[kenji-miyake]

@shmpwk Thank you for your suggestion!

Telling the background, this page is modified from Autoware.Auto's documentation.

• Remove ADE.
• Remove SVL simulator. (due to its EOL 😢)
• Aggregate distributed information such as https://autowarefoundation.gitlab.io/autoware.auto/AutowareAuto/building.html#building-colcon-defaults
  • Because I think it's also "installation".

And regarding your suggestion, I feel it's good to discuss with some concrete examples.
So if you have any concrete ideas, please submit a PR, and let's discuss them there! 😄

[shmpwk]

Thank you for your supports, the background helps me to understand the direction of the documetaion.

And I notice that "Tools for users" should be left as it is until adding the new simulator, and should change the name for "Tools for developer".
I created the PR for the improvement.
autowarefoundation/autoware-documentation#104