minor: adding some doc-block comments