Feature/docs muffato

Created by: muffato

Hello,

I'm looking into building an automatic OO-API on top of REST, and I've found a few discrepancies in the configuration files

Cheers, Matthieu