doc markup fixes