WWW - General Notes

[Luke-Ferderer]

In order to not flood the issues, this acts as a master issue for all general notes from the website mostly related to the instructions provided. Comments can be made to this rather than creating new issues.

[Luke-Ferderer]

To improve the building experience, it would be helpful to line up bag numbers with lesson numbers such that everything that is needed for lesson 5, for instance, is in bag 5.

[Luke-Ferderer]

For Build Hadabot: Overview of Motors and Breadboards, I have the following notes:

• Step 2:
  • The note about preventing shorting seems like it is important enough to put in the main text rather than as a footnote.
  • It might be good to specify that the breadboard back should not be removed yet.
  • This step has the user test their motors to make sure they work; this is good. But, it does not provide any trouble shooting steps for users if their motors do not work.
  • When building my kit, for instance, I had to solder on one new wire to both of the motors due to a faulty wire.

[Luke-Ferderer]

For Build Hadabot: Build the Differential Drive, I have the following notes:

• Step 1:
  • I don't think it is reasonable to expect users to have a "blade style 5.5mm wrench". The link to an Amazon page to buy one is good, but if I've clicked into this step, I want to build the robot. I don't want to wait a few days for a wrench to arrive from Amazon. Is there a way to either include a cheap wrench with the kit (similar to including an Allan wrench with assemble-it-yourself furniture) or a way to let users know what tools they will need when they purchase the kit. Then, they can buy it ahead of time if they need it.
• Step 3:
  • The mounting of the caster could likely benefit from additional instructions. Right now, the only text is "Use the hardware - mount the caster to the rear 4 holes on the platform" which might not be detailed enough for some people.
• General notes:
  • For the pictures, many of them are from vastly different directions than the previous ones. This can make keeping the orientation of the Hadabot strait difficult. I would keep the robot's orientation the same between pictures when possible and add something that signifies how robot's orientation has been changed when it can't be keep the same (similar to how Lego instructions are done).

[Luke-Ferderer]

For Build Hadabot: Add the Motor Controller, I have the following notes:

• Step 2:
  • Making the pictures larger would greatly help this step. Being able to see the orientation of the board in the photos is the easiest way to explain how it should be mounted.
  • Your picture for threading the wires has many more wires than are on the robot at this point. I had though I was missing something
• Step 3:
  • This step says "Despite the images showing our breadboard being stuck on the platform, do NOT stick the breadboard on to the platform yet!!". But, step 2 had the user stick the breadboard down. This should be changed to match the current ordering of steps.

[jschrier]

For Step 6/10 of Build Hadabot: Set up the ESP32 (using CLI tools) to interface with ROS 2

Command line instruction should read esptool.py --chip esp32 read_mac (instruction on web are missing the .py suffix)

[jschrier]

For Step 4/5 of Range Sensors Add-On: Finish the Assembly and Wires

Command line instructions at the bottom of the page refer to ros2 topic echo /hadabot/range_sensor/fl

However, the current version of the hadabot firmware ( https://github.com/hadabot/hadabot_main/blob/master/firmware/uhadabot/main.py) actually publishes this as a single Int32MultiArray topic /hadabot/ir_sensors_12bit_adc

(It appears that the previous lesson about installing the first range sensor was correctly updated, but not the subsequent lesson about multiple sensors