Added some hints regarding compilation and how to solve compile errors

Quite a few hints on how to resolve compilation issues. Annotated REST controller example with a few remarks regarding the semantics of what