Doc updates and test additions

does not really matter, but could be made `const` just to ease the reading