YP docs should use more sphinx admonitions

  while there are *tons* of "note" admonitions in the YP docs, sphinx
supports a fair number of other admonitions that i think should get
more use:

https://sphinx-book-theme.readthedocs.io/en/stable/reference/kitchen-sink/admonitions.html

rday