Update spec folder documentation

Luc Yriarterequested to merge
public-spec-readme into master

Part of the README was obsolete, as we don't maintain a sanitized version of the auto-generated spec anymore.

Merge request reports