feature: content negotiation

closes #6
reformat examples, release notes