docs: get the comments & generated doc up-to-date