Add compiler diagnostics section

[bernardnormier]

We should add a Compiler diagnostics section that lists the errors and warnings that slicec-cs can emit.

For each error and warning, we should provide an explanation (more than the message) and when appropriate provide an example.