chore: Update devices documentation with design details

This documents the current code base as is with a higher level overview. This may deserve a better home after we've removed the original API, but seems Ok fr now.

Author: allenporter