If something fails for example https://github.com/CarterCommunity/Carter/blob/master/src/Carter/OpenApi/CarterOpenApi.cs#L30 we need to log why.

Might be worth logging other areas to highlight what's going on in the output generation

Currently the only documentation comes in the readme. The projects needs some more.

@colin-young, do you have any suggestions with regard to human-facing documentation? In last project we created some documentation with mkdocs. It's simple enough written in markdown and has a familiar ReadTheDocs-like theme.

In JsonLd.Entities I went the path of code-as-d

It would be really nice if you can provide a detailed tutorial from start to finish. Where you begin with a new project; go through installing and setting up Nancy with this library for use. It would help a great deal. I'm currently struggling to make this to work, but don't know if there are steps that i missed, or just did them wrong.