docs: definitions, small fixes