v1.0

• Major changes:
  • Add Data and Typeable instances for Data.Swagger types;
  • Merge ParamType/ItemsType/SchemaType into SwaggerType GADT;
  • Merge collection format types into CollectionFormat GADT;
  • Introduce SwaggerItems GADT, replacing Items and SchemaItems in ParamSchema (see #24);
  • Move type, format and items fields to ParamSchema (former SchemaComon);
  • Prepend reference path automatically (see commit 49d1fad)
    and thus remove "#/definitions/" from user code, leaving much clearer Reference "Name";
  • Change Data.Swagger.Schema (see #19):
    • Change the only method of ToSchema to declareNamedSchema which should produce a NamedSchema
      along with a list of schema definitions used to produce it;
    • Add declareSchema, declareSchemaRef;
    • Replace genericTo* helpers with genericDeclare* helpers;
    • Add paramSchemaTo[Named]Schema helpers to facilitate code reuse for primitive schemas;
    • Add helpers for inlining Schema references dynamically (see #23);
  • Add ToParamSchema class (see #17) with
    • generic default implementation and
    • instances for some base types compliant with http-api-data instances;
  • Add Data.Swagger.Declare module with
    • DeclareT monad transformer;
    • MonadDeclare type class;
    • various helpers;
  • Rename parameter-related types:
    • Parameter -> Param;
    • ParameterSchema -> ParamAnySchema;
    • ParameterOtherSchema -> ParamOtherSchema;
    • ParameterLocation -> ParamLocation;
    • SchemaCommon -> ParamSchema;
    • parameter* fields renamed to param* fields;
    • schemaCommon* fields renamed to paramSchema* fields;
    • HasSchemaCommon -> HasParamSchema.
• Minor changes:
  • Replace TH-generated JSON instances with Generic-based (see #25);
  • Drop template-haskell dependency;
  • Omit empty array/object properties from toJSON output (#22);
  • Remove minLength property from schemas for time types;
  • Move SchemaOptions to Data.Swagger.SchemaOptions;
  • Remove useReferences from SchemaOptions (see #23);
  • Place all internal submodules under Data.Swagger.Internal;
  • Better documentation (see #26).