doc: add commentary section, ran checkdoc