trivial: clarify values in documents