document all the things :speech_balloon: