README.md

 # librehost api
 
-Librehoster API JSON schema
+Librehost API JSON schema
 
 Proposed format for json schema v0.0.1
 
-{
-    "@context" : "http://schema.org",
-    "@type" : "Organization",
-    "organizationType" : "Informal collective",
-    "name" : "librehoster.example",
-    "tagLine" : "providing services for everyone",
-    "homeUrl" : "https://librehoster.example",
-    "logo" : "https://librehoster.example/logo.png",
-    "description": "libre service provider",
-    "communicationLanguages": ["en", "fr", "nl"],
-    "contactUrl": "https://librehoster.example/contact",
-    "privacyPolicyUrl" : "https://librehoster.example/policy/privacy",
-    "termsOfServiceUrl" : "https://librehoster.example/policy/tos",
-    "isServiceProvider" : true,
-    "foundingDate": "YYYY",
-    "version": "0.0.1",
-    "dateCreated": "YYYY-MM-DDTHH:MM:54Z",
-    "dateModified": "2018-11-10T22:32:54Z"
-}
+This is planned to be expanded with option fields for services, locations,
+values and admins/people. Its expected to be available at /librehost.json
 
-This is planned to be expanded with option fields for services, locations, values and admins/people
\ No newline at end of file
+## Details
+
++ `@context` (`string`): Set this to `http://schema.org`
++ `version` (`string`): This is the version of the schema. Do **not** update
+  this if you update your `librehost.json`.
++ `@type` (`string`): Type of the site which the `librehost.json` represents.
++ `organizationType` (`string`): Type of the organization.
++ `name` (`string`): Name of the the organization.
++ `tagLine` (`string`): The tagline of the organization.
++ `homeUrl` (`string`): URL of the homepage of the organization.
++ `logo` (`string`): Link to image file of the logo of the organization.
++ `description` (`string`): Description of the organization.
++ `communicationLanguages` (`array(string)`): Array of [ISO 639-1
+  codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) of the
+  languages that the admins can be contacted in.
++ `contactUrl` (`string`): URL where info to contact the admins can be found or
+  the admins can be contacted.
++ `privacyPolicyUrl` (`string`): URL where the Privacy Policy resides.
++ `termsOfServiceUrl` (`string`): URL where the Terms of Service reside.
++ `isServiceProvider` (`boolean`): Denotes whether the said organization
+  provides services.
++ `foundingDate` (`int`): Year of founding of the organization.
++ `dateCreated` (`string`): [ISO Date Time
+  String](https://en.wikipedia.org/wiki/ISO_8601) (`YYYY-MM-DDTHH:MM:SSZ` in
+  UTC) denoting when the file was created.
++ `dateModified` (`string`): ISO Date Time String denoting when the file was
+  last modified. Update this line everytime you make a change to the
+  `librehost.json`.

librehoster.json → librehost.json

 {
     "@context" : "http://schema.org",
+    "version": "0.0.1",
     "@type" : "Organization",
     "organizationType" : "Informal collective",
     "name" : "librehoster.example",
@@ -13,7 +14,6 @@
     "termsOfServiceUrl" : "https://librehoster.example/policy/tos",
     "isServiceProvider" : true,
     "foundingDate": "YYYY",
-    "version": "0.0.1",
-    "dateCreated": "YYYY-MM-DDTHH:MM:54Z",
+    "dateCreated": "YYYY-MM-DDTHH:MM:SSZ",
     "dateModified": "2018-11-10T22:32:54Z"
-}
\ No newline at end of file
+}