[DOC] slight REST tweaks for clarity