Notes from hands-on-lab user testing

These notes were taken in a ux research session 2019-12-17 and need to be folded into the hands-on-lab:

• no chance to early test - is the API working? how to judge success after a step?

• request_debug exercise at the end? maybe mark as more advanced content

• add steps to verify being able to talk to hub/emulator without puppet

• "link button press" when starting out

• step 6: hub1.conf - what the f?

• step 6: explain where to locate the attributes hash

• step 6: remove 'ensure' from attributes example

• step 6: replace DESC heredoc with regular string

• step 6: add require 'faraday'

• hue_put context argument does not line up with other examples

• fix default bri value in traffic_lights.pp to something more bright (250?)

• add --trace --verbose --debug everywhere to improve debugging when things go wrong

• note that lights in a non-plain-color mode will not react to just setting hue/bri

Locate the hands-on-lab content and review the listed usability notes, especially step 6, the request_debug and hue_put examples, and traffic_lights.pp. Check each requested explanation, verification step, debugging option, example correction, and light-behavior note, then confirm the lab is understandable and testable from start to finish.