[doc] document the things