Documentation tweaks

[jsoref]

I tripped on #88 and I'm wondering if part of the problem was that I didn't understand how to properly enable osiris for my endpoint. I think highlighting the bits one needs to change would help...