Typos and editorial changes

Henry's remarks

Update src/oas.md

Better explanation for custom anchor

Co-Authored-By: Lorna Jane Mitchell <github@lornajane.net>

Author: ralfhandl