• Describe what was missing from the documentation and/or what was incorrect/incomplete.
  In the quick reference section on PWM for the RP2 port,

http://docs.micropython.org/en/latest/rp2/quickref.html#pwm-pulse-width-modulation

the (apparent) link with the text "use the machine.PWM class" is not really a link. All the other IO sections on that page have a similar link which does take you to the indicated doc.

I assume that the machine.PWM "link" should indeed be clickable, and not that the PWM section is special and intentionally did NOT have an active link. I think the correct link is:

https://docs.micropython.org/en/latest/library/machine.PWM.html#machine-pwm

that URL being obtained by taking the similar UART link and replacing "UART" with "PWM"