Fix doc paths to be readthedocs friendly

Signed-off-by: Matthew Ballance <matt.ballance@gmail.com>

Author: Matthew Ballance

doc/requirements.txt

@@ -1,5 +1,6 @@
 
 lxml
+pyyaml
 python-jsonschema-objects
 jsonschema
 sphinx-jsonschema

doc/source/reference/coverage_report_json.rst

@@ -11,16 +11,17 @@ The JSON coverage-report format is a direct transcription of the
 Coverage Report Object API.
 
 
-.. jsonschema:: ../../schema/covreport.json
+.. jsonschema:: ../../../src/ucis/schema/covreport.json
 
-.. jsonschema:: ../../schema/covreport.json#/defs/coverageReportType
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/coverageReportType
 
-.. jsonschema:: ../../schema/covreport.json#/defs/typeCovergroupType
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/typeCovergroupType
 
-.. jsonschema:: ../../schema/covreport.json#/defs/instCovergroupType
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/instCovergroupType
 
-.. jsonschema:: ../../schema/covreport.json#/defs/coverpointType
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/coverpointType
 
-.. jsonschema:: ../../schema/covreport.json#/defs/crossType
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/crossType
+
+.. jsonschema:: ../../../src/ucis/schema/covreport.json#/defs/coverBinType
 
-.. jsonschema:: ../../schema/covreport.json#/defs/coverBinType

…ce/recording_coverage_base_practices.rst …ce/recording_coverage_best_practices.rstdoc/source/reference/recording_coverage_base_practices.rst renamed to doc/source/reference/recording_coverage_best_practices.rst doc/source/reference/recording_coverage_base_practices.rst renamed to doc/source/reference/recording_coverage_best_practices.rst

@@ -10,12 +10,12 @@ tools to create and process.
 Format Reference
 ================
 
-.. jsonschema:: ../../schema/coverage.json
+.. jsonschema:: ../../../src/ucis/schema/coverage.json
 
 Every coverage-data document has a `coverage` element as its root. Currently,
 the only sub-elements is a list of covergroup types.
 
-.. jsonschema:: ../../schema/coverage.json#/defs/covergroupType
+.. jsonschema:: ../../../src/ucis/schema/coverage.json#/defs/covergroupType
 
 A type covergroup provides data about a covergroup type. All instances
 of a covergroup type have the same coverpoints and crosses. All 
@@ -24,26 +24,26 @@ Merged type coverage (the union of coverage achieved by all instances)
 is derived by PyUCIS from the instance coverage, and is not specified
 in the coverage file.
 
-.. jsonschema:: ../../schema/coverage.json#/defs/covergroupInstType
+.. jsonschema:: ../../../src/ucis/schema/coverage.json#/defs/covergroupInstType
 
 An instance covergroup provides data about a covergroup instance. 
 
 
-.. jsonschema:: ../../schema/coverage.json#/defs/coverpointType
+.. jsonschema:: ../../../src/ucis/schema/coverage.json#/defs/coverpointType
 
 A coverpoint lists a set of bins that it is monitoring. Each
 coverpoint can specify an `atleast` count to specify that a
 bin must contain `atleast` hits in order to count as being covered.
 By default, `atleast` is 1.
 
-.. jsonschema:: ../../schema/coverage.json#/defs/crossType
+.. jsonschema:: ../../../src/ucis/schema/coverage.json#/defs/crossType
 
 A cross lists the set of coverpoints from which it is composed,
 and lists its cross bins.  Each cross can specify an `atleast` 
 count to specify that a bin must contain `atleast` hits in 
 order to count as being covered. By default, `atleast` is 1.
 
-.. jsonschema:: ../../schema/coverage.json#/defs/coverBinType
+.. jsonschema:: ../../../src/ucis/schema/coverage.json#/defs/coverBinType
 
 A coverbin associates a bin name with the number of hits 
 in that bin.