joffrey-bion / livedoc

A not-so-annotation-based documentation generator for REST and websocket services
MIT License
4 stars 2 forks source link

Add option to document collections as if they were arrays #26

Open joffrey-bion opened 7 years ago

joffrey-bion commented 7 years ago

Once serialized in JSON, there is little use in making a distinction between a list, a set, and an array. They are all [a, b, c] in the JSON.

The only pieces of information the actual type brings are:

Although it may be useful information in some cases, I would imagine that in most cases, we don't really care. When we don't care, it could be nice to avoid the noise of having different collection names by using a plain array notation like MyType[].