better content negotiation docs

closes #193