Add more robust Tor API documentation
Currently, Tor's API is not well-documented- adding more rich documentation (and ideally a separate how-to technical guide) would be helpful for external applications to learn how to embed tor.
For example, tor_control_socket_t needs documentation. https://gitweb.torproject.org/tor.git/tree/src/feature/api/tor_api.h#n60
Furthermore, it isn't clear what are the tradeoffs between embedding Tor or running it as an executable: https://gitweb.torproject.org/tor.git/tree/src/feature/api/tor_api.h#n11
Also, it would be helpful to add additional documentation about how to interface with tor once it has been invoked (e.g, reading/writing from the control port via SOCKS). https://gitweb.torproject.org/tor.git/tree/src/feature/api/tor_api.h#n26