Skip to content

Conversation

hilary-luo
Copy link
Contributor

@hilary-luo hilary-luo commented Jul 5, 2023

This is a major change to the structure of how to access information on the website and how the non-nav data is managed.

The major changes are as follows:

  • Reducing the number of tabs at the top by combining all robot accessories into one entry under robots (includes manipulators, computers, sensors etc). Renaming Software to ROS to better reflect the contents. Both of these changes better reflect the layout of our marketing website.

  • Removing the tools tab and redistributing the information

    • NTP and IP address info moved under networking under ROS
    • PACs listed as its own accessories page
    • Physical Tools and Colours moved to a common section under robots
  • Moving OutdoorNav and IndoorNav to the navbar to make them easy to find and give emphasis as products

  • Added versioning drop downs, 1 for robots + ROS and 1 for outdoorNav. These are responsive in that they only show up when you are browsing that section of the website. These default to the latest version the first time you access them and automatically update for new versions. OutdoorNav also has a legacy version listed which takes you to a page with links to the old documentation.

  • Left side bar only shows the relevant information for the tab that you are browsing.

  • Robot & ROS sections are versioned by ROS version (currently ROS 1 Noetic or ROS 2 Humble). Thus, ROS 2 information has been removed from the ROS 1 version and vice versa

  • Filling the ROS 2 ROS tab with documentation for the humble software release

Relevant notes:

  • Some images and components are being versioned within the docs folders while images and components that are common across ROS 1 and ROS 2 documentation are still in the static and components folders respectively. In the future as we update hardware pages we could convert more of that into common components to prevent having to maintain mutliple copies of the same information.

  • Links had to all be changed to relative links in order for the versioning to work properly (shortcuts were taken in the ROS 1 version for obsolete components - not deemed worth the effort to turn into relative links)

  • "Next" version is now being hidden and has to be enabled if we want to use it for development.

  • Readme was updated to reflect the new processes

hilary-luo and others added 30 commits June 15, 2023 15:50
Added PS4 controller image
@hilary-luo hilary-luo marked this pull request as ready for review July 7, 2023 17:19
@roni-kreinin
Copy link
Contributor

LGTM

Copy link
Collaborator

@jhiggins-cpr jhiggins-cpr left a comment

Choose a reason for hiding this comment

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

Just one change

@rhysfaultless-cpr
Copy link
Member

@hilary-luo please squash-and-merge this one when you are ready.
Squashing will simplify the rebase process for other people.
I do not intend to review this since @jhiggins-cpr already has.

@hilary-luo hilary-luo merged commit 3f99cc4 into development Jul 7, 2023
@rhysfaultless-cpr rhysfaultless-cpr deleted the ros2-humble branch July 10, 2023 16:05
hilary-luo added a commit that referenced this pull request Aug 3, 2023
* Changed the tabs and restructured the files to reflect that

* Added versioning to the robot / ROS section of the website

* Added dropdowns to manage versioning

* Correcting sidebar order

* Reduced how much information is displayed in the sidebar

* Added ROS 2 Humble Documentation

---------

Co-authored-by: Roni Kreinin <rkreinin@clearpathrobotics.com>
Co-authored-by: Tony Baltovski <tbaltovski@clearpathrobotics.com>
Co-authored-by: Luis Camero <lcamero@clearpathrobotics.com>
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.

6 participants