Add docs building support

Signed-off-by: Roni Riska <roni.riska@nokia.com>
Change-Id: I288f12169f99665edc2a9ef71de1925766306738

diff --git a/.gitignore b/.gitignore
new file mode 100644 (file)
index 0000000..bdb4219
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+.tox
+docs/_build/

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644 (file)
index 0000000..095222a
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,16 @@
+---
+version: 2
+
+formats:
+  - htmlzip
+
+build:
+  image: latest
+
+python:
+  version: 3.7
+  install:
+    - requirements: docs/requirements-docs.txt
+
+sphinx:
+  configuration: docs/conf.py

diff --git a/docs/_static/logo.png b/docs/_static/logo.png
new file mode 100644 (file)
index 0000000..c3b6ce5
Binary files /dev/null and b/docs/_static/logo.png differ

diff --git a/docs/conf.py b/docs/conf.py
new file mode 100644 (file)
index 0000000..922e22f
--- /dev/null
+++ b/docs/conf.py
@@ -0,0 +1,6 @@
+from docs_conf.conf import *
+linkcheck_ignore = [
+    'http://localhost.*',
+    'http://127.0.0.1.*',
+    'https://gerrit.o-ran-sc.org.*'
+]

diff --git a/docs/conf.yaml b/docs/conf.yaml
new file mode 100644 (file)
index 0000000..eb87731
--- /dev/null
+++ b/docs/conf.yaml
@@ -0,0 +1,3 @@
+---
+project_cfg: oran
+project: com-golog

diff --git a/docs/favicon.ico b/docs/favicon.ico
new file mode 100644 (file)
index 0000000..00b0fd0
Binary files /dev/null and b/docs/favicon.ico differ

diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644 (file)
index 0000000..0f20d89
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,43 @@
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+..     https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+Welcome to O-RAN SC tracelibcpp Documentation\r
+=============================================\r
+\r
+.. toctree::\r
+   :maxdepth: 2\r
+   :caption: Contents:\r
+\r
+   overview.rst\r
+   release-notes.rst\r
+\r
+\r
+\r
+* :ref:`genindex`\r
+* :ref:`modindex`\r
+* :ref:`search`
\ No newline at end of file

diff --git a/docs/overview.rst b/docs/overview.rst
new file mode 100644 (file)
index 0000000..dc31408
--- /dev/null
+++ b/docs/overview.rst
@@ -0,0 +1,34 @@
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+..     https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+tracelibcpp Overview\r
+====================\r
+\r
+This library implements a function for creating a configured tracer instance.\r
+It hides the underlaying tracer implementation from the application.\r
+The library currently supports only Jaeger (https://www.jaegertracing.io/) C++ client (https://github.com/jaegertracing/jaeger-client-cpp) tracer implementation.\r

diff --git a/docs/release-notes.rst b/docs/release-notes.rst
new file mode 100644 (file)
index 0000000..40456e6
--- /dev/null
+++ b/docs/release-notes.rst
@@ -0,0 +1,117 @@
+..\r
+.. Copyright (c) 2019 AT&T Intellectual Property.\r
+..\r
+.. Copyright (c) 2019 Nokia.\r
+..\r
+..\r
+.. Licensed under the Creative Commons Attribution 4.0 International\r
+..\r
+.. Public License (the "License"); you may not use this file except\r
+..\r
+.. in compliance with the License. You may obtain a copy of the License at\r
+..\r
+..\r
+..     https://creativecommons.org/licenses/by/4.0/\r
+..\r
+..\r
+.. Unless required by applicable law or agreed to in writing, documentation\r
+..\r
+.. distributed under the License is distributed on an "AS IS" BASIS,\r
+..\r
+.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r
+..\r
+.. See the License for the specific language governing permissions and\r
+..\r
+.. limitations under the License.\r
+..\r
+\r
+\r
+Release-Notes\r
+=============\r
+\r
+\r
+This document provides the release notes for v0.0.4 of tracelibcpp.\r
+\r
+.. contents::\r
+   :depth: 3\r
+   :local:\r
+\r
+\r
+Version history\r
+---------------\r
+\r
++--------------------+--------------------+--------------------+--------------------+\r
+| **Date**           | **Ver.**           | **Author**         | **Comment**        |\r
+|                    |                    |                    |                    |\r
++--------------------+--------------------+--------------------+--------------------+\r
+| 2019-09-04         | 0.0.4              | R Riska            | First version      |\r
+|                    |                    |                    |                    |\r
++--------------------+--------------------+--------------------+--------------------+\r
+\r
+\r
+Summary\r
+-------\r
+\r
+This is the first version of this library.\r
+It implements a function for creating a configured tracer instance.\r
+\r
+\r
+\r
+\r
+Release Data\r
+------------\r
+\r
+This is the first version of this library.\r
+\r
+\r
+\r
+Feature Additions\r
+^^^^^^^^^^^^^^^^^\r
+\r
+Bug Corrections\r
+^^^^^^^^^^^^^^^\r
+\r
+\r
+Deliverables\r
+^^^^^^^^^^^^\r
+\r
+Software Deliverables\r
++++++++++++++++++++++\r
+\r
+This version contains:\r
+\r
+- tracelibcpp/tracelibcpp.hpp header file\r
+- tracelibcpp library\r
+\r
+It can be retrieved from https://gerrit.o-ran-sc.org/r/ric-plt/tracelibcpp.git.\r
+\r
+\r
+Documentation Deliverables\r
+++++++++++++++++++++++++++\r
+\r
+\r
+\r
+\r
+\r
+Known Limitations, Issues and Workarounds\r
+-----------------------------------------\r
+\r
+System Limitations\r
+^^^^^^^^^^^^^^^^^^\r
+\r
+\r
+\r
+Known Issues\r
+^^^^^^^^^^^^\r
+\r
+Workarounds\r
+^^^^^^^^^^^\r
+\r
+\r
+\r
+\r
+\r
+References\r
+----------\r
+\r
+\r

diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
new file mode 100644 (file)
index 0000000..09a0c1c
--- /dev/null
+++ b/docs/requirements-docs.txt
@@ -0,0 +1,5 @@
+sphinx
+sphinx-rtd-theme
+sphinxcontrib-httpdomain
+recommonmark
+lfdocs-conf

diff --git a/tox.ini b/tox.ini
new file mode 100644 (file)
index 0000000..ac38348
--- /dev/null
+++ b/tox.ini
@@ -0,0 +1,38 @@
+# documentation only
+[tox]
+minversion = 2.0
+envlist =
+    docs,
+    docs-linkcheck,
+skipsdist = true
+
+[testenv:docs]
+passenv =
+   http_proxy
+   https_proxy
+
+basepython = python3
+deps =
+    sphinx
+    sphinx-rtd-theme
+    sphinxcontrib-httpdomain
+    recommonmark
+    lfdocs-conf
+
+commands =
+    sphinx-build -W -b html -n -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/html
+    echo "Generated docs available in {toxinidir}/docs/_build/html"
+whitelist_externals = echo
+
+[testenv:docs-linkcheck]
+passenv =
+   http_proxy
+   https_proxy
+
+basepython = python3
+deps = sphinx
+       sphinx-rtd-theme
+       sphinxcontrib-httpdomain
+       recommonmark
+       lfdocs-conf
+commands = sphinx-build -W -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck