Context is lost by having docs out of the repo and displayed on the website

[kurbeco]

Consider

emon32-fw/docs/firmware.md at 01e05a0ed69932668f6a4592098f7ec1210abe5d · openenergymonitor/emon32-fw · GitHub (source)

vs

Firmware — OpenEnergyMonitor 0.0.1 documentation (RTD output)

There are paths in the source that make sense in the repo context (paths to scripts or binaries) that don’t in the output.