Document a versioning scheme and the pre 1.0.0 state (fiatconnect#56)

README.md

@@ -1,2 +1,21 @@
-# specification
-FiatConnect API Specification
+# FiatConnect
+
+The FiatConnect API Specification.
+
+## Specification
+
+[fiatconnect-api.md](./fiatconnect-api.md) describes the FiaConnect
+API specification.
+
+[swagger.yaml](./swagger.yaml) is an OpenAPI 2.0 specification for
+FiatConnect.
+
+## Versioning
+
+We use [semantic versioning](https://semver.org/) to version the
+API specification.
+
+The API specification is stil under initial developemnt. We're working
+towards a 1.0.0 release and try hard to avoid breaking changes, but
+anything MAY change at any time. The API specification SHOULD NOT be
+considered stable.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "specification",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "FiatConnect API Specification",
   "repository": "https://github.com/fiatconnect/specification.git",
   "scripts": {

swagger.yaml

@@ -1,7 +1,7 @@
 swagger: "2.0"
 info:
   description: "FiatConnect provides a standardized server-side API specification for CICO providers to provide cash-in/cash-out functionality to clients."
-  version: "1.0.0"
+  version: "0.1.0"
   title: "FiatConnect Specification"
 tags:
 - name: "clock"