Beef up docs a bit

[nihonjinrxs]

Just noting that we should follow my own guidelines for project docs on this one too. 😝 (I can take this one on if you'd prefer that.)