doc: document a couple of constants
doc: full sentence in comment