Merge pull request #50 from awwright/master

Fix a lot of id/ref/dereferencing problems

Makefile

@@ -2,7 +2,7 @@ XML2RFC=xml2rfc
 
 OUT = \
 	jsonschema-core.html jsonschema-core.txt \
-	jsonschema-schema.html jsonschema-schema.txt \
+	jsonschema-validation.html jsonschema-validation.txt \
 	jsonschema-hyperschema.html jsonschema-hyperschema.txt
 
 

README.md

@@ -3,16 +3,36 @@
 This repository contains the current, and historical, JSON Schema
 specifications.
 
+
 ## Call for reviews
 
 Specifications are starting to get written. Reviews, comments and suggestions
 are of paramount importance to JSON Schema. It is humbly asked to you, dear
 reader, that you bring your contribution.
 
+
+## Contents
+
+Makefile - scripts to build the Internet-Draft txt/html
+archive - files for other/older JSON Schema implementations
+hyper-schema.json - the JSON Hyper-schema meta-schema
+schema.json - the JSON Schema meta-schema
+jsonschema-core.xml - sources for "core" spec
+jsonschema-validation - sources for JSON Schema validation
+jsonschema-hyperschema.xml - sources for hyper-schema spec
+
+Type "make" at a shell to build the .txt and .html spec files.
+
+A primer on the RFC XML format is at <https://xml2rfc.tools.ietf.org/authoring/draft-mrose-writing-rfcs.html>
+
+
 ## The website
 
 The JSON Schema web site is at http://json-schema.org/
 
+The source for the website is maintained in a separate repository.
+
+
 ## License
 
 The source material in this repository is licensed under the AFL or BSD license.