clarify documentation markup