summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSamriddhi Jain <j.samriddhi13@gmail.com>2017-07-14 19:27:24 +0530
committerSamriddhi Jain <j.samriddhi13@gmail.com>2017-07-17 23:23:01 +0530
commit9fc60292c0f1e89d9da9a2d9ec0fb38a8472066a (patch)
tree7ec7d0dee0b8ef28171e7df6d7650067d8961577
parent88064cffa79dd807782eff9e167d6e7724d74171 (diff)
downloadpycadf-9fc60292c0f1e89d9da9a2d9ec0fb38a8472066a.tar.gz
Turn on warning-is-error for sphinx build
The doc-migration spec requires all projects to treat warnings as errors during sphinx build. This patches turns that function on and resolves the error (detailed below) coming as a result of it. The code block in event_concept.rst file is currently made to render in javascript which is an incorrect syntax for it. Change-Id: Id7fee247b76ed7cfebb849305e0611bc966709be
-rw-r--r--doc/source/event_concept.rst16
-rw-r--r--setup.cfg1
2 files changed, 9 insertions, 8 deletions
diff --git a/doc/source/event_concept.rst b/doc/source/event_concept.rst
index 3e77ce5..df07eef 100644
--- a/doc/source/event_concept.rst
+++ b/doc/source/event_concept.rst
@@ -89,7 +89,7 @@ details):
"eventTime": "2014-02-27T19:29:30.855665+0000",
"target": {
"typeURI": "service/compute/node",
- # optional Endpoints to describe compute node,
+ // optional Endpoints to describe compute node,
"addresses": [
{
"url": "http://9.26.26.250:8774/v2/e7e2bcc9c0df4f3eabcd412ae62503f6",
@@ -108,9 +108,9 @@ details):
"name": "nova"
},
"observer": {
- "id": "target" # shortform to show Observer Resource is the same as Target,
+ "id": "target" // shortform to show Observer Resource is the same as Target,
},
- # tags use to query events on,
+ // tags use to query events on,
"tags": [
"correlation_id?value=56cdde6f-6b4e-48a4-94e6-defb40522fb2"
],
@@ -118,12 +118,12 @@ details):
"initiator": {
"typeURI": "data/security/account/user",
"name": "admin",
- # optional Credential to describe resource,
+ // optional Credential to describe resource,
"credential": {
"token": "MIIQzgYJKoZIhvcNAQcCoIIQvzCCELsC xxxxxxxx zqvD9OPWZm7VQpYNK2EvrZi-mTvb5A==",
"identity_status": "Confirmed"
},
- # optional Host to describe resource,
+ // optional Host to describe resource,
"host": {
"agent": "python-novaclient",
"address": "9.26.26.250"
@@ -131,12 +131,12 @@ details):
"project_id": "e7e2bcc9c0df4f3eabcd412ae62503f6",
"id": "68a3f50705a54f799ce94380fc02ed8a"
},
- # optional Reason for activity event,
+ // optional Reason for activity event,
"reason": {
"reasonCode": "200",
"reasonType": "HTTP"
},
- # list of Resources which edited event,
+ // list of Resources which edited event,
"reporterchain": [
{
"reporterTime": "2014-02-27T19:29:31.043902+0000",
@@ -149,7 +149,7 @@ details):
"action": "authenticate/logon",
"outcome": "success",
"id": "0a196053-95de-48f8-9890-4527b25b5007",
- # Event model is extensible so additional attributes may be added to describe model,
+ // Event model is extensible so additional attributes may be added to describe model,
"requestPath": "/v2/e7e2bcc9c0df4f3eabcd412ae62503f6/os-certificates"
}
diff --git a/setup.cfg b/setup.cfg
index 51cf8b5..d7c470b 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -39,6 +39,7 @@ setup-hooks =
source-dir = doc/source
build-dir = doc/build
all_files = 1
+warning-is-error = 1
[upload_sphinx]
upload-dir = doc/build/html