F json specification doc

This branch enhances the documentation with an annotated and referenced cfood yaml schema.

This is currently a proof of concept.

Still todo:

• doc/ will become the main location for the schema.
• Add references and descriptions of the schema in the docs.