[docs] pedantry

Closes #8982