Better documentation (and correction wrt default value) of the display parameter.

[jonquet]

After discarding PR#20 we need to change the MOD-API Swagger spec with a better documentation (and correction wrt default value) of the display parameter.

We need to :

• Show an example of a given property or property list
• List the properties returned by the default (absence of the parameter) according to Each endoint need to define its defeault returned attributes, and not allways put display=all #17
• Show that display=all is possible

Originally posted by @jonquet in #20 (comment)

[jonquet]

@antony-wilson As the master of the Swagger doc, can you do this ? ;)

[antony-wilson]

The default values were added for SemanticArtefact, SemanticArtefactCatalog and SemanticArtefactCatalogRecord,
see #17 (comment), in pull request #44