Handle array properties and assorted fixes

[masterzen]

This contains a set of fix from @teintuc to the swagger template so that:

• description appears
• required properties are generated correctly
• array properties are handled as arrays by puppet