Update Sphinx
- Bump versions in requirements.txt
Remove sphinx docs which were duplicated everywhere, refer to ONF main
docs site which is more complete.
Replace logo with SVG version
- Was a WebP saved as .png which broke in some browsers.
- Shift logo to sidebar, as in all other docs sites.
Cleanup Makefile
Change how the dict.txt sorter works
- Only check the dict.txt for changes
- Give human-intelligible results
Add correct licensing info for fonts
Add code of conduct and link
Change-Id: Ie4334cfea826e348eca4c93ed62a3633b33ad87c
diff --git a/.reuse/dep5 b/.reuse/dep5
index 3998153..f85f3a7 100644
--- a/.reuse/dep5
+++ b/.reuse/dep5
@@ -1,5 +1,9 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Files: VERSION images/* _static/* dict.txt
+Files: VERSION images/* *.png *.svg dict.txt
Copyright: 2021 Open Networking Foundation
License: Apache-2.0
+
+Files: _static/fonts/Inconsolata*.ttf
+Copyright: 2006 Raph Levien
+License: OFL-1.1
diff --git a/LICENSES/OFL-1.1.txt b/LICENSES/OFL-1.1.txt
new file mode 100644
index 0000000..6fe84ee
--- /dev/null
+++ b/LICENSES/OFL-1.1.txt
@@ -0,0 +1,43 @@
+SIL OPEN FONT LICENSE
+
+Version 1.1 - 26 February 2007
+
+PREAMBLE
+
+The goals of the Open Font License (OFL) are to stimulate worldwide development of collaborative font projects, to support the font creation efforts of academic and linguistic communities, and to provide a free and open framework in which fonts may be shared and improved in partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and redistributed freely as long as they are not sold by themselves. The fonts, including any derivative works, can be bundled, embedded, redistributed and/or sold with any software provided that any reserved names are not used by derivative works. The fonts and derivatives, however, cannot be released under any other type of license. The requirement for fonts to remain under this license does not apply to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+
+"Font Software" refers to the set of files released by the Copyright Holder(s) under this license and clearly marked as such. This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting, or substituting — in part or in whole — any of the components of the Original Version, by changing formats or by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of the Font Software, to use, study, copy, merge, embed, modify, redistribute, and sell modified and unmodified copies of the Font Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components, in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled, redistributed and/or sold with any software, provided that each copy contains the above copyright notice and this license. These can be included either as stand-alone text files, human-readable headers or in the appropriate machine-readable metadata fields within text or binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font Name(s) unless explicit written permission is granted by the corresponding Copyright Holder. This restriction only applies to the primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font Software shall not be used to promote, endorse or advertise any Modified Version, except to acknowledge the contribution(s) of the Copyright Holder(s) and the Author(s) or with their explicit written permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must be distributed entirely under this license, and must not be distributed under any other license. The requirement for fonts to remain under this license does not apply to any document created using the Font Software.
+
+TERMINATION
+
+This license becomes null and void if any of the above conditions are not met.
+
+DISCLAIMER
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/Makefile b/Makefile
index 79f2f4b..2accb01 100644
--- a/Makefile
+++ b/Makefile
@@ -13,9 +13,9 @@
BUILDDIR ?= _build
# name of python virtualenv that is used to run commands
-VENV_NAME := venv-docs
+VENV_NAME := venv-docs
-.PHONY: help test lint doc8 reload Makefile prep format format-dict
+.PHONY: help Makefile test doc8 dict-check sort-dict license clean clean-all
# Put it first so that "make" without argument is like "make help".
help: $(VENV_NAME)
@@ -24,34 +24,26 @@
# Create the virtualenv with all the tools installed
$(VENV_NAME):
- python3 -m venv $(VENV_NAME) ;\
+ python3 -m venv $@ ;\
source $@/bin/activate ;\
pip install -r requirements.txt
-# automatically reload changes in browser as they're made
-reload: $(VENV_NAME)
- source $</bin/activate ; set -u ;\
- sphinx-reload $(SOURCEDIR)
-
# lint and link verification. linkcheck is part of sphinx
-test: lint spelling linkcheck dict-check
+test: license doc8 dict-check spelling linkcheck
-lint: doc8
-
-doc8: $(VENV_NAME) | $(OTHER_REPO_DOCS)
+doc8: $(VENV_NAME)
source $</bin/activate ; set -u ;\
- doc8 --max-line-length 119 \
- $$(find . -name \*.rst ! -path "*venv*" ! -path "*vendor*" ! -path "*repos*" )
+ doc8 --ignore-path $< --ignore-path _build --ignore-path LICENSES --max-line-length 119
# Words in dict.txt must be in the correct alphabetical order and must not duplicated.
-dict-check: format-dict
- @git update-index --refresh
+dict-check: sort-dict
+ @set -u ;\
+ git diff --exit-code dict.txt && echo "dict.txt is sorted" && exit 0 || \
+ echo "dict.txt is unsorted or needs to be added to git index" ; exit 1
-format: format-dict
-
-format-dict:
- @cat dict.txt | sort -u > /tmp/sorted.txt
- @mv /tmp/sorted.txt dict.txt
+sort-dict:
+ @sort -u < dict.txt > dict_sorted.txt
+ @mv dict_sorted.txt dict.txt
license: $(VENV_NAME)
source $</bin/activate ; set -u ;\
@@ -73,6 +65,6 @@
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
-%: $(VENV_NAME) Makefile | $(OTHER_REPO_DOCS) $(STATIC_DOCS)
+%: $(VENV_NAME) Makefile
source $</bin/activate ; set -u ;\
$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/README b/README
new file mode 100644
index 0000000..2242cf7
--- /dev/null
+++ b/README
@@ -0,0 +1,20 @@
+.. SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
+ SPDX-License-Identifier: Apache-2.0
+
+SD-Fabric Docs
+==============
+
+This site contains Sphinx format documentation for the SD-Fabric project.
+Please see the `Sphinx section of ONF Docs
+<https://docs.opennetworking.org/docs/sphinx.html>`_ for instructions on how to
+contribute to this documentation.
+
+Code of Conduct
+---------------
+
+We expect all ONF employees, member companies, and participants to abide by our
+`Code of Conduct <https://docs.opennetworking.org/policies/conduct.html>`_
+
+If you are being harassed, notice that someone else is being harassed, or have
+any other concerns involving someone’s welfare, please notify a member of the
+ONF team or email conduct@opennetworking.org.
diff --git a/_static/sdfabric-logo.svg b/_static/sdfabric-logo.svg
new file mode 100644
index 0000000..8f4c879
--- /dev/null
+++ b/_static/sdfabric-logo.svg
@@ -0,0 +1,469 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ viewBox="0 0 652.672 164.57201"
+ height="164.57201"
+ width="652.672"
+ xml:space="preserve"
+ id="svg10"
+ version="1.1"><metadata
+ id="metadata16"><rdf:RDF><cc:Work
+ rdf:about=""><dc:format>image/svg+xml</dc:format><dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" /><dc:title></dc:title></cc:Work></rdf:RDF></metadata><defs
+ id="defs14"><linearGradient
+ id="linearGradient38"
+ spreadMethod="pad"
+ gradientTransform="matrix(-25.885633,0,0,25.885633,299.95264,89.291786)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop32"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop34"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop36"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient60"
+ spreadMethod="pad"
+ gradientTransform="matrix(-11.779641,0,0,11.779641,242.1467,77.442841)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop54"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop56"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop58"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient82"
+ spreadMethod="pad"
+ gradientTransform="matrix(24.925671,0,0,-24.925671,245.76665,88.672928)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop76"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop78"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop80"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient104"
+ spreadMethod="pad"
+ gradientTransform="matrix(-19.801184,0,0,19.801184,266.68707,105.49477)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop98"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop100"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop102"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient126"
+ spreadMethod="pad"
+ gradientTransform="matrix(49.189957,0,0,-49.189957,192.71567,80.886955)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop120"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop122"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop124"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient148"
+ spreadMethod="pad"
+ gradientTransform="matrix(34.249996,0,0,-34.249996,261.16101,77.218475)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop142"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop144"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop146"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><radialGradient
+ id="radialGradient170"
+ spreadMethod="pad"
+ gradientTransform="matrix(4.7418118,0,0,-4.7418118,272.06717,113.35149)"
+ gradientUnits="userSpaceOnUse"
+ r="1"
+ cy="0"
+ cx="0"
+ fy="0"
+ fx="0"><stop
+ id="stop164"
+ offset="0"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop166"
+ offset="0.42888146"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop168"
+ offset="1"
+ style="stop-opacity:1;stop-color:#7a1214" /></radialGradient><radialGradient
+ id="radialGradient192"
+ spreadMethod="pad"
+ gradientTransform="matrix(4.7418118,0,0,-4.7418118,300.5437,64.290573)"
+ gradientUnits="userSpaceOnUse"
+ r="1"
+ cy="0"
+ cx="0"
+ fy="0"
+ fx="0"><stop
+ id="stop186"
+ offset="0"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop188"
+ offset="0.42888146"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop190"
+ offset="1"
+ style="stop-opacity:1;stop-color:#7a1214" /></radialGradient><radialGradient
+ id="radialGradient214"
+ spreadMethod="pad"
+ gradientTransform="matrix(4.7418118,0,0,-4.7418118,243.96782,64.290573)"
+ gradientUnits="userSpaceOnUse"
+ r="1"
+ cy="0"
+ cx="0"
+ fy="0"
+ fx="0"><stop
+ id="stop208"
+ offset="0"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop210"
+ offset="0.42888146"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop212"
+ offset="1"
+ style="stop-opacity:1;stop-color:#7a1214" /></radialGradient><linearGradient
+ id="linearGradient236"
+ spreadMethod="pad"
+ gradientTransform="matrix(-33.973312,0,0,33.973312,255.24791,100.87108)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop230"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop232"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop234"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient258"
+ spreadMethod="pad"
+ gradientTransform="matrix(11.959739,0,0,-11.959739,217.20126,99.777351)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop252"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop254"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop256"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><linearGradient
+ id="linearGradient280"
+ spreadMethod="pad"
+ gradientTransform="matrix(25.902388,0,0,-25.902388,188.11638,89.279274)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop274"
+ offset="0"
+ style="stop-opacity:1;stop-color:#7a1214" /><stop
+ id="stop276"
+ offset="0.51721552"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop278"
+ offset="1"
+ style="stop-opacity:1;stop-color:#c72026" /></linearGradient><radialGradient
+ id="radialGradient302"
+ spreadMethod="pad"
+ gradientTransform="matrix(4.7418118,0,0,-4.7418118,187.55688,64.290573)"
+ gradientUnits="userSpaceOnUse"
+ r="1"
+ cy="0"
+ cx="0"
+ fy="0"
+ fx="0"><stop
+ id="stop296"
+ offset="0"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop298"
+ offset="0.42888146"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop300"
+ offset="1"
+ style="stop-opacity:1;stop-color:#7a1214" /></radialGradient><radialGradient
+ id="radialGradient324"
+ spreadMethod="pad"
+ gradientTransform="matrix(4.7418118,0,0,-4.7418118,215.98611,113.35149)"
+ gradientUnits="userSpaceOnUse"
+ r="1"
+ cy="0"
+ cx="0"
+ fy="0"
+ fx="0"><stop
+ id="stop318"
+ offset="0"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop320"
+ offset="0.42888146"
+ style="stop-opacity:1;stop-color:#c72026" /><stop
+ id="stop322"
+ offset="1"
+ style="stop-opacity:1;stop-color:#7a1214" /></radialGradient><clipPath
+ id="clipPath334"
+ clipPathUnits="userSpaceOnUse"><path
+ id="path332"
+ d="M 0,123.429 H 489.504 V 0 H 0 Z" /></clipPath><linearGradient
+ id="linearGradient370"
+ spreadMethod="pad"
+ gradientTransform="matrix(57.958984,0,0,-57.958984,167.73528,24.408737)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop364"
+ offset="0"
+ style="stop-opacity:1;stop-color:#1c407d" /><stop
+ id="stop366"
+ offset="0.65772165"
+ style="stop-opacity:1;stop-color:#027bc1" /><stop
+ id="stop368"
+ offset="1"
+ style="stop-opacity:1;stop-color:#027bc1" /></linearGradient><clipPath
+ id="clipPath380"
+ clipPathUnits="userSpaceOnUse"><path
+ id="path378"
+ d="M 0,123.429 H 489.504 V 0 H 0 Z" /></clipPath><linearGradient
+ id="linearGradient404"
+ spreadMethod="pad"
+ gradientTransform="matrix(56.302734,0,0,-56.302734,344.19815,24.408737)"
+ gradientUnits="userSpaceOnUse"
+ y2="0"
+ x2="1"
+ y1="0"
+ x1="0"><stop
+ id="stop398"
+ offset="0"
+ style="stop-opacity:1;stop-color:#027bc1" /><stop
+ id="stop400"
+ offset="0.81819"
+ style="stop-opacity:1;stop-color:#1fc4f4" /><stop
+ id="stop402"
+ offset="1"
+ style="stop-opacity:1;stop-color:#1fc4f4" /></linearGradient><clipPath
+ id="clipPath414"
+ clipPathUnits="userSpaceOnUse"><path
+ id="path412"
+ d="M 0,123.429 H 489.504 V 0 H 0 Z" /></clipPath></defs><g
+ transform="matrix(1.3333333,0,0,-1.3333333,0,164.572)"
+ id="g18"><g
+ id="g20"><g
+ id="g22"><g
+ id="g28"><g
+ id="g30"><path
+ id="path40"
+ style="fill:url(#linearGradient38);stroke:none"
+ d="m 274.067,106.362 22.097,-36.247 c 1.264,1.05 3.789,1.47 3.789,1.47 v 0 l -22.486,36.884 c 0,0 -1.022,-1.363 -3.4,-2.107" /></g></g></g></g><g
+ id="g42"><g
+ id="g44"><g
+ id="g50"><g
+ id="g52"><path
+ id="path62"
+ style="fill:url(#linearGradient60);stroke:none"
+ d="m 230.367,83.604 8.329,-14.333 c 0,0 1.323,1.534 3.451,2.023 v 0 l -8.321,14.319 z" /></g></g></g></g><g
+ id="g64"><g
+ id="g66"><g
+ id="g72"><g
+ id="g74"><path
+ id="path84"
+ style="fill:url(#linearGradient82);stroke:none"
+ d="m 245.767,71.342 c 0,0 1.76,-0.365 3.452,-2.022 v 0 l 21.473,36.903 c 0,0 -1.673,0.172 -3.601,1.803 v 0 z" /></g></g></g></g><g
+ id="g86"><g
+ id="g88"><g
+ id="g94"><g
+ id="g96"><path
+ id="path106"
+ style="fill:url(#linearGradient104);stroke:none"
+ d="m 246.885,101.216 3.969,-2.306 15.833,9.557 c -1.48,1.477 -1.768,3.612 -1.768,3.612 v 0 z" /></g></g></g></g><g
+ id="g108"><g
+ id="g110"><g
+ id="g116"><g
+ id="g118"><path
+ id="path128"
+ style="fill:url(#linearGradient126);stroke:none"
+ d="m 192.715,69.329 c 0,0 1.28,-0.91 1.924,-3.51 v 0 l 47.267,27.823 -3.956,2.313 z" /></g></g></g></g><g
+ id="g130"><g
+ id="g132"><g
+ id="g138"><g
+ id="g140"><path
+ id="path150"
+ style="fill:url(#linearGradient148);stroke:none"
+ d="M 261.161,84.982 293.46,66.005 c 0.482,1.935 1.951,3.493 1.951,3.493 v 0 l -32.225,18.933 z" /></g></g></g></g><g
+ id="g152"><g
+ id="g154"><g
+ id="g160"><g
+ id="g162"><path
+ id="path172"
+ style="fill:url(#radialGradient170);stroke:none"
+ d="m 267.325,113.351 c 0,-2.619 2.123,-4.742 4.742,-4.742 v 0 c 2.619,0 4.742,2.123 4.742,4.742 v 0 c 0,2.619 -2.123,4.742 -4.742,4.742 v 0 c -2.619,0 -4.742,-2.123 -4.742,-4.742" /></g></g></g></g><g
+ id="g174"><g
+ id="g176"><g
+ id="g182"><g
+ id="g184"><path
+ id="path194"
+ style="fill:url(#radialGradient192);stroke:none"
+ d="m 295.801,64.292 c 0,-2.62 2.123,-4.743 4.742,-4.743 v 0 c 2.62,0 4.742,2.123 4.742,4.743 v 0 c 0,2.618 -2.122,4.741 -4.742,4.741 v 0 c -2.619,0 -4.742,-2.123 -4.742,-4.741" /></g></g></g></g><g
+ id="g196"><g
+ id="g198"><g
+ id="g204"><g
+ id="g206"><path
+ id="path216"
+ style="fill:url(#radialGradient214);stroke:none"
+ d="m 239.226,64.292 c 0,-2.62 2.123,-4.743 4.741,-4.743 v 0 c 2.62,0 4.743,2.123 4.743,4.743 v 0 c 0,2.618 -2.123,4.741 -4.743,4.741 v 0 c -2.618,0 -4.741,-2.123 -4.741,-4.741" /></g></g></g></g><g
+ id="g218"><g
+ id="g220"><g
+ id="g226"><g
+ id="g228"><path
+ id="path238"
+ style="fill:url(#linearGradient236);stroke:none"
+ d="m 221.275,108.436 31.955,-18.673 2.018,3.454 -32.073,18.762 c 0,0 -0.33,-2.085 -1.9,-3.543" /></g></g></g></g><g
+ id="g240"><g
+ id="g242"><g
+ id="g248"><g
+ id="g250"><path
+ id="path260"
+ style="fill:url(#linearGradient258);stroke:none"
+ d="m 217.201,106.222 8.503,-14.617 3.457,2.01 -8.337,14.336 c 0,0 -1.446,-1.396 -3.623,-1.729" /></g></g></g></g><g
+ id="g262"><g
+ id="g264"><g
+ id="g270"><g
+ id="g272"><path
+ id="path282"
+ style="fill:url(#linearGradient280);stroke:none"
+ d="m 188.116,71.543 c 0,0 2.086,-0.05 3.796,-1.459 v 0 l 22.107,36.288 c -1.912,0.484 -3.407,2.102 -3.407,2.102 v 0 z" /></g></g></g></g><g
+ id="g284"><g
+ id="g286"><g
+ id="g292"><g
+ id="g294"><path
+ id="path304"
+ style="fill:url(#radialGradient302);stroke:none"
+ d="m 182.815,64.292 c 0,-2.62 2.123,-4.743 4.742,-4.743 v 0 c 2.618,0 4.741,2.123 4.741,4.743 v 0 c 0,2.618 -2.123,4.741 -4.741,4.741 v 0 c -2.619,0 -4.742,-2.123 -4.742,-4.741" /></g></g></g></g><g
+ id="g306"><g
+ id="g308"><g
+ id="g314"><g
+ id="g316"><path
+ id="path326"
+ style="fill:url(#radialGradient324);stroke:none"
+ d="m 211.243,113.351 c 0,-2.619 2.124,-4.742 4.743,-4.742 v 0 c 2.619,0 4.743,2.123 4.743,4.742 v 0 c 0,2.619 -2.124,4.742 -4.743,4.742 v 0 c -2.619,0 -4.743,-2.123 -4.743,-4.742" /></g></g></g></g><g
+ id="g328"><g
+ clip-path="url(#clipPath334)"
+ id="g330"><g
+ transform="translate(266.0895,17.1182)"
+ id="g336"><path
+ id="path338"
+ style="fill:#0078ba;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 h -32.987 c -1.542,0 -2.791,1.249 -2.791,2.79 0,1.541 1.249,2.791 2.791,2.791 L 0,5.581 C 1.541,5.581 2.79,4.331 2.79,2.79 2.79,1.249 1.541,0 0,0" /></g><g
+ transform="translate(229.9401,10.0088)"
+ id="g340"><path
+ id="path342"
+ style="fill:#0078ba;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 c -0.721,-0.864 -1.609,-1.296 -2.664,-1.296 -0.961,0 -1.776,0.335 -2.448,1.008 -0.673,0.672 -1.008,1.487 -1.008,2.448 0,0.864 0.239,1.56 0.72,2.088 l 17.496,23.544 c 0.815,1.104 1.895,2.004 3.24,2.7 1.343,0.695 2.783,1.044 4.319,1.044 1.441,0 2.809,-0.312 4.105,-0.935 1.296,-0.625 2.35,-1.489 3.168,-2.593 l 17.496,-23.4 c 0.288,-0.337 0.527,-0.709 0.72,-1.116 0.191,-0.408 0.288,-0.852 0.288,-1.332 0,-0.961 -0.337,-1.776 -1.008,-2.448 -0.673,-0.673 -1.488,-1.008 -2.448,-1.008 -1.153,0 -2.065,0.456 -2.737,1.368 L 22.464,22.464 c -0.337,0.384 -0.757,0.804 -1.261,1.261 -0.504,0.455 -1.02,0.683 -1.548,0.683 -0.528,0 -1.044,-0.228 -1.548,-0.683 -0.503,-0.457 -0.9,-0.877 -1.187,-1.261 z" /></g><g
+ transform="translate(11.9518,21.709)"
+ id="g344"><path
+ id="path346"
+ style="fill:#1c407d;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 c -1.152,0.504 -2.16,1.187 -3.024,2.052 -0.865,0.864 -1.548,1.872 -2.052,3.024 -0.504,1.152 -0.756,2.4 -0.756,3.743 0,1.344 0.252,2.593 0.756,3.744 0.504,1.153 1.187,2.161 2.052,3.025 0.864,0.864 1.872,1.548 3.024,2.052 1.151,0.504 2.398,0.756 3.743,0.756 h 43.704 c 0.96,0 1.776,-0.336 2.449,-1.008 0.67,-0.673 1.007,-1.489 1.007,-2.449 0,-0.96 -0.337,-1.776 -1.007,-2.447 -0.673,-0.673 -1.489,-1.009 -2.449,-1.009 H 3.6 C 2.879,11.483 2.242,11.231 1.691,10.728 1.139,10.224 0.863,9.587 0.863,8.819 0.863,8.1 1.139,7.476 1.691,6.948 2.242,6.419 2.879,6.156 3.6,6.156 h 39.816 c 1.343,0 2.603,-0.253 3.779,-0.757 1.176,-0.503 2.197,-1.187 3.061,-2.051 0.863,-0.865 1.547,-1.884 2.052,-3.06 0.504,-1.177 0.755,-2.437 0.755,-3.78 0,-1.345 -0.251,-2.592 -0.755,-3.744 -0.505,-1.153 -1.189,-2.16 -2.052,-3.024 -0.864,-0.864 -1.885,-1.537 -3.061,-2.016 -1.176,-0.481 -2.436,-0.72 -3.779,-0.72 H -0.217 c -0.961,0 -1.776,0.335 -2.447,1.008 -0.674,0.672 -1.009,1.487 -1.009,2.448 0,0.959 0.335,1.775 1.009,2.448 0.671,0.671 1.486,1.008 2.447,1.008 h 43.92 c 0.721,0 1.344,0.252 1.872,0.756 0.529,0.504 0.792,1.116 0.792,1.836 0,0.767 -0.263,1.415 -0.792,1.944 -0.528,0.527 -1.151,0.792 -1.872,0.792 H 3.743 C 2.398,-0.756 1.151,-0.504 0,0" /></g><g
+ transform="translate(80.5671,33.1924)"
+ id="g348"><path
+ id="path350"
+ style="fill:#1c407d;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 v -17.567 h 37.008 c 1.632,0 2.976,0.298 4.032,0.899 1.056,0.6 1.884,1.332 2.484,2.196 0.6,0.865 1.008,1.812 1.224,2.844 0.217,1.032 0.324,1.981 0.324,2.845 0,0.863 -0.107,1.81 -0.324,2.844 -0.216,1.031 -0.624,1.979 -1.224,2.843 -0.6,0.865 -1.428,1.596 -2.484,2.197 C 39.984,-0.3 38.64,0 37.008,0 Z m 51.768,-8.783 c 0,-1.777 -0.288,-3.577 -0.864,-5.401 -0.576,-1.825 -1.404,-3.48 -2.484,-4.967 -1.08,-1.489 -2.389,-2.725 -3.924,-3.708 -1.537,-0.985 -3.288,-1.525 -5.256,-1.62 H -3.455 c -0.961,0 -1.777,0.334 -2.449,1.007 -0.672,0.672 -1.008,1.488 -1.008,2.449 V 3.456 c 0,0.96 0.336,1.775 1.008,2.448 0.672,0.672 1.488,1.008 2.449,1.008 h 41.976 c 2.063,0 3.911,-0.48 5.543,-1.439 1.631,-0.961 3.024,-2.197 4.176,-3.708 1.153,-1.513 2.028,-3.194 2.628,-5.04 0.6,-1.849 0.9,-3.685 0.9,-5.508" /></g></g></g><g
+ id="g352"><g
+ id="g354"><g
+ id="g360"><g
+ id="g362"><path
+ id="path372"
+ style="fill:url(#linearGradient370);stroke:none"
+ d="m 180.983,40.105 c -2.065,0 -3.913,-0.481 -5.545,-1.44 v 0 c -1.632,-0.961 -3.023,-2.196 -4.175,-3.708 v 0 c -1.153,-1.513 -2.029,-3.193 -2.628,-5.04 v 0 c -0.601,-1.849 -0.9,-3.685 -0.9,-5.508 v 0 -12.24 c 0,-0.961 0.335,-1.777 1.008,-2.448 v 0 c 0.672,-0.673 1.487,-1.008 2.447,-1.008 v 0 c 0.96,0 1.776,0.335 2.45,1.008 v 0 c 0.67,0.671 1.007,1.487 1.007,2.448 v 0 12.744 c 0.047,0.863 0.18,1.776 0.396,2.736 v 0 c 0.216,0.959 0.612,1.86 1.188,2.7 v 0 c 0.577,0.84 1.367,1.523 2.375,2.051 v 0 c 1.008,0.529 2.305,0.792 3.889,0.792 v 0 h 39.744 c 0.959,0 1.775,0.337 2.447,1.009 v 0 c 0.672,0.671 1.008,1.488 1.008,2.448 v 0 c 0,0.959 -0.336,1.775 -1.008,2.448 v 0 c -0.672,0.671 -1.488,1.008 -2.447,1.008 v 0 z m 2.304,-12.24 c -0.961,0 -1.777,-0.337 -2.448,-1.008 v 0 c -0.673,-0.673 -1.008,-1.489 -1.008,-2.448 v 0 c 0,-0.96 0.335,-1.776 1.008,-2.448 v 0 c 0.671,-0.673 1.487,-1.008 2.448,-1.008 v 0 h 37.296 c 0.958,0 1.776,0.335 2.447,1.008 v 0 c 0.672,0.672 1.009,1.488 1.009,2.448 v 0 c 0,0.959 -0.337,1.775 -1.009,2.448 v 0 c -0.671,0.671 -1.489,1.008 -2.447,1.008 v 0 z" /></g></g></g></g><g
+ id="g374"><g
+ clip-path="url(#clipPath380)"
+ id="g376"><g
+ transform="translate(286.1667,15.625)"
+ id="g382"><path
+ id="path384"
+ style="fill:#0078ba;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 h 39.959 c 0.721,0 1.355,0.263 1.908,0.792 0.551,0.527 0.828,1.151 0.828,1.872 0,0.767 -0.277,1.403 -0.828,1.908 -0.553,0.504 -1.187,0.756 -1.908,0.756 H 0 Z M 0,17.567 V 12.24 h 40.031 c 0.721,0 1.344,0.239 1.872,0.72 0.529,0.479 0.792,1.103 0.792,1.872 0,0.72 -0.277,1.355 -0.828,1.908 -0.553,0.551 -1.187,0.827 -1.908,0.827 z M -5.904,-5.904 c -0.674,0.672 -1.008,1.487 -1.008,2.448 v 24.479 c 0,0.96 0.334,1.776 1.008,2.449 0.672,0.672 1.486,1.007 2.447,1.007 h 43.129 c 1.343,0 2.602,-0.251 3.779,-0.755 1.176,-0.504 2.207,-1.188 3.096,-2.052 0.889,-0.864 1.584,-1.885 2.088,-3.061 0.504,-1.176 0.756,-2.436 0.756,-3.779 0,-1.2 -0.204,-2.316 -0.612,-3.349 -0.408,-1.032 -0.948,-1.956 -1.62,-2.771 0.672,-0.816 1.212,-1.74 1.62,-2.773 0.408,-1.032 0.612,-2.124 0.612,-3.275 0,-1.345 -0.252,-2.592 -0.756,-3.744 -0.504,-1.152 -1.199,-2.16 -2.088,-3.024 -0.889,-0.864 -1.92,-1.548 -3.096,-2.052 -1.177,-0.504 -2.436,-0.756 -3.779,-0.756 H -3.457 c -0.961,0 -1.775,0.335 -2.447,1.008" /></g></g></g><g
+ id="g386"><g
+ id="g388"><g
+ id="g394"><g
+ id="g396"><path
+ id="path406"
+ style="fill:url(#linearGradient404);stroke:none"
+ d="m 347.653,40.105 c -0.961,0 -1.776,-0.337 -2.447,-1.008 v 0 c -0.674,-0.673 -1.008,-1.489 -1.008,-2.448 v 0 c 0,-0.96 0.334,-1.777 1.008,-2.448 v 0 c 0.671,-0.672 1.486,-1.009 2.447,-1.009 v 0 h 43.416 c 0.721,0 1.355,-0.263 1.908,-0.792 v 0 c 0.551,-0.528 0.828,-1.151 0.828,-1.872 v 0 c 0,-0.767 -0.277,-1.403 -0.828,-1.907 v 0 c -0.553,-0.504 -1.187,-0.756 -1.908,-0.756 v 0 h -38.16 c -1.248,0 -2.4,-0.228 -3.455,-0.684 v 0 c -1.057,-0.457 -1.969,-1.08 -2.736,-1.872 v 0 c -0.769,-0.792 -1.382,-1.728 -1.836,-2.808 v 0 c -0.457,-1.08 -0.684,-2.22 -0.684,-3.42 v 0 -6.912 c 0,-0.961 0.334,-1.777 1.008,-2.448 v 0 c 0.671,-0.673 1.486,-1.008 2.447,-1.008 v 0 c 0.912,0 1.716,0.335 2.412,1.008 v 0 c 0.696,0.671 1.045,1.487 1.045,2.448 v 0 6.12 c 0,0.72 0.215,1.319 0.648,1.8 v 0 c 0.431,0.48 0.959,0.768 1.584,0.864 v 0 h 14.327 c 2.593,0 5.088,-0.313 7.488,-0.936 v 0 c 2.4,-0.625 4.717,-1.465 6.948,-2.52 v 0 c 2.233,-1.057 4.38,-2.256 6.445,-3.6 v 0 c 2.062,-1.344 4.079,-2.736 6.047,-4.176 v 0 c 0.816,-0.673 1.632,-1.008 2.449,-1.008 v 0 c 0.958,0 1.775,0.335 2.447,1.008 v 0 c 0.671,0.671 1.008,1.487 1.008,2.448 v 0 c 0,0.672 -0.192,1.26 -0.575,1.764 v 0 c -0.385,0.504 -0.842,0.947 -1.369,1.332 v 0 c -1.392,1.103 -2.76,2.124 -4.103,3.06 v 0 c -1.345,0.936 -2.664,1.811 -3.961,2.628 v 0 h 0.289 c 1.343,0 2.603,0.252 3.779,0.756 v 0 c 1.176,0.504 2.208,1.188 3.096,2.052 v 0 c 0.888,0.864 1.584,1.872 2.088,3.024 v 0 c 0.504,1.152 0.756,2.399 0.756,3.743 v 0 c 0,1.344 -0.252,2.593 -0.756,3.745 v 0 c -0.504,1.152 -1.2,2.16 -2.088,3.024 v 0 c -0.888,0.864 -1.92,1.548 -3.096,2.052 v 0 c -1.176,0.504 -2.436,0.756 -3.779,0.756 v 0 z" /></g></g></g></g><g
+ id="g408"><g
+ clip-path="url(#clipPath414)"
+ id="g410"><g
+ transform="translate(415.0436,9.7207)"
+ id="g416"><path
+ id="path418"
+ style="fill:#50b2de;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 c -0.672,-0.673 -1.488,-1.008 -2.447,-1.008 -0.961,0 -1.777,0.335 -2.449,1.008 -0.672,0.672 -1.007,1.487 -1.007,2.448 v 24.48 c 0,0.96 0.335,1.775 1.007,2.448 0.672,0.672 1.488,1.008 2.449,1.008 0.959,0 1.775,-0.336 2.447,-1.008 0.672,-0.673 1.009,-1.488 1.009,-2.448 V 2.448 C 1.009,1.487 0.672,0.672 0,0" /></g><g
+ transform="translate(424.6921,24.4092)"
+ id="g420"><path
+ id="path422"
+ style="fill:#50b2de;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="m 0,0 c 0,1.823 0.3,3.659 0.9,5.508 0.6,1.846 1.477,3.527 2.628,5.04 1.152,1.512 2.544,2.747 4.177,3.708 1.631,0.959 3.479,1.439 5.543,1.439 h 41.977 c 0.959,0 1.775,-0.336 2.449,-1.007 0.67,-0.673 1.008,-1.489 1.008,-2.449 0,-0.96 -0.338,-1.776 -1.008,-2.447 C 57,9.119 56.184,8.783 55.225,8.783 H 14.76 c -1.68,0 -3.035,-0.3 -4.068,-0.899 C 9.66,7.283 8.844,6.552 8.244,5.687 7.644,4.823 7.236,3.875 7.021,2.844 6.805,1.811 6.696,0.863 6.696,0 c 0,-0.864 0.109,-1.812 0.325,-2.845 0.215,-1.032 0.623,-1.979 1.223,-2.843 0.6,-0.865 1.416,-1.597 2.448,-2.197 1.033,-0.6 2.388,-0.899 4.068,-0.899 h 40.465 c 0.959,0 1.775,-0.337 2.449,-1.008 0.67,-0.673 1.008,-1.489 1.008,-2.448 0,-0.961 -0.338,-1.777 -1.008,-2.448 -0.674,-0.673 -1.49,-1.008 -2.449,-1.008 H 12.528 c -1.968,0 -3.719,0.479 -5.256,1.439 -1.536,0.96 -2.844,2.196 -3.923,3.708 C 2.269,-9.036 1.44,-7.345 0.864,-5.473 0.289,-3.601 0,-1.776 0,0" /></g><g
+ transform="translate(163.1862,26.8409)"
+ id="g424"><path
+ id="path426"
+ style="fill:#1c407d;fill-opacity:1;fill-rule:nonzero;stroke:none"
+ d="M 0,0 C 0.671,-0.672 1.007,-1.487 1.007,-2.445 1.007,-3.405 0.671,-4.22 0,-4.891 -0.672,-5.562 -1.486,-5.897 -2.445,-5.897 h -21.576 c -0.864,0.095 -1.608,0.467 -2.23,1.114 -0.624,0.647 -0.936,1.427 -0.936,2.338 0,0.958 0.335,1.773 1.007,2.445 0.671,0.671 1.487,1.007 2.446,1.007 H -2.445 C -1.486,1.007 -0.672,0.671 0,0" /></g></g></g></g></svg>
diff --git a/conf.py b/conf.py
index e949e7a..a124a7b 100644
--- a/conf.py
+++ b/conf.py
@@ -100,13 +100,13 @@
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path.
exclude_patterns = [
- '*/LICENSE.md',
- '*/vendor',
'.DS_Store',
+ 'LICENSE',
+ 'README',
'Thumbs.db',
'_build',
- 'venv-docs',
'requirements.txt',
+ 'venv-docs',
]
# The name of the Pygments (syntax highlighting) style to use.
@@ -119,17 +119,13 @@
#
html_theme = 'sphinx_rtd_theme'
-# html_logo = '_static/sdfabric.svg'
+html_logo = '_static/sdfabric-logo.svg'
html_favicon = '_static/sdfabric-favicon-128.png'
-# Theme options are theme-specific and customize the look and feel of a theme
-# further. For a list of options available for each theme, see the
-# documentation.
-#
-# html_theme_options = {
-# 'logo_only': True
-# }
+html_theme_options = {
+ 'logo_only': True
+}
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
@@ -259,13 +255,12 @@
# -- options for Intersphinx extension ---------------------------------------
intersphinx_mapping = {
- 'ansible': ('https://docs.ansible.com/ansible/latest', None),
- 'sphinx': ('https://www.sphinx-doc.org/en/master', None),
'trellis': ('https://docs.trellisfabric.org/master', None),
+ 'aether': ('https://docs.aetherproject.org/master', None),
+ 'onf': ('https://docs.opennetworking.org/', None),
'sysapproach5g': ('https://5g.systemsapproach.org/', None),
'sysapproachnet': ('https://book.systemsapproach.org/', None),
'sysapproachsdn': ('https://sdn.systemsapproach.org/', None),
- 'aether': ('https://docs.aetherproject.org/master', None),
}
def setup(app):
diff --git a/images/overview-logo.png b/images/overview-logo.png
deleted file mode 100644
index 4cafdc1..0000000
--- a/images/overview-logo.png
+++ /dev/null
Binary files differ
diff --git a/index.rst b/index.rst
index 3c3ce81..dcfb678 100644
--- a/index.rst
+++ b/index.rst
@@ -1,12 +1,10 @@
.. SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
.. SPDX-License-Identifier: Apache-2.0
-.. image:: images/overview-logo.png
- :width: 400px
- :align: center
-Overview
-========
+
+SD-Fabric
+=========
SD-Fabric is an open source, full stack, deeply programmable network fabric optimized for edge cloud,
5G, and Industry 4.0 applications.
@@ -49,7 +47,7 @@
Highlights
-==========
+----------
.. image:: images/overview-topo.png
:width: 500px
@@ -105,11 +103,3 @@
release/process.rst
release/1*
-
-.. toctree::
- :maxdepth: 2
- :caption: Misc
- :hidden:
- :glob:
-
- readme
diff --git a/quickstart.rst b/quickstart.rst
index 43917d9..c1da2fa 100644
--- a/quickstart.rst
+++ b/quickstart.rst
@@ -5,8 +5,14 @@
===========
.. note::
- We have recently migrated the BMV2 version of ``fabric.p4`` to ``fabric-tna`` repository (and renamed it to ``fabric-v1model.p4``).
- We plan to build a software-emulated, Docker-based environment using ``fabric-v1model.p4``
- such that people can easily try out SD-Fabric without hardware equipments.
- We also plan to use the same environment for SD-Fabric smoke test in the future.
- Stay tuned.
+ We have recently migrated the BMV2 version of ``fabric.p4`` to ``fabric-tna``
+ repository (and renamed it to ``fabric-v1model.p4``).
+
+ We plan to build a software-emulated, Docker-based environment using
+ ``fabric-v1model.p4`` such that people can easily try out SD-Fabric without
+ hardware.
+
+ We also plan to use the same environment for SD-Fabric smoke test in the future.
+
+ Stay tuned.
+
diff --git a/readme.rst b/readme.rst
deleted file mode 100644
index 58f0ff0..0000000
--- a/readme.rst
+++ /dev/null
@@ -1,83 +0,0 @@
-.. SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
-.. SPDX-License-Identifier: Apache-2.0
-
-Documentation Guide
-===================
-
-Writing Documentation
----------------------
-
-Docs are generated using :doc:`Sphinx <sphinx:usage/index>`.
-
-Documentation is written in :doc:`reStructuredText
-<sphinx:usage/restructuredtext/basics>` - see this link for the basic format.
-
-In reStructuredText documents, to create the section hierarchy (mapped in HTML
-to ``<h1>`` through ``<h5>``) use these characters to underline headings in the
-order given: ``=``, ``-`` ``"``, ``'``, ``^``.
-
-Referencing other Documentation
--------------------------------
-
-Other Sphinx-built documentation, both ONF and non-ONF can be linked to using
-:doc:`Intersphinx <sphinx:usage/extensions/intersphinx>`.
-
-You can see all link targets available on a remote Sphinx's docs by running::
-
- python -msphinx.ext.intersphinx http://otherdocs/objects.inv
-
-Building the Docs
-------------------
-
-The documentation build process is stored in the ``Makefile``. Building docs
-requires Python to be installed, and most steps will create a virtualenv
-(``venv_docs``) which contains the required tools. You may also need to
-install the ``enchant`` C library using your system's package manager for the
-spelling checker to function properly.
-
-Run ``make html`` to generate html documentation in ``_build/html``.
-
-To check the formatting of documentation, run ``make lint``. This will be done
-in Jenkins to validate the documentation, so please do this before you create a
-patchset.
-
-To check spelling, run ``make spelling``. If there are additional words that
-are correctly spelled but not in the dictionary (acronyms, trademarks, etc.)
-please add them to the ``dict.txt`` file.
-
-Creating new Versions of Docs
------------------------------
-
-To change the version shown on the built site, change the contents of the
-``VERSION`` file.
-
-There is a ``make multiversion`` target which will build all versions published
-on the remote to ``_build``. This will use `sphinx-multiversion
-<https://github.com/Holzhaus/sphinx-multiversion>`_ to build multiple versions
-of the site.
-
-Adding Images and Diagrams
---------------------------
-
-There are multiple ways to add images and diagrams to the documentation.
-Generally, you should prefer using `SVG
-<https://en.wikipedia.org/wiki/Scalable_Vector_Graphics>`_ images, as these can
-be scaled to any size without quality loss.
-
-If you're creating diagrams, there are multiple tools available.
-:doc:`Graphviz <sphinx:usage/extensions/graphviz>` can render inline text-based
-graphs definitions and diagrams within the documentation, and is best for
-simple diagrams.
-
-More complex diagrams can be created in `Diagrams.net/Draw.io
-<https://www.diagrams.net/>`_ format. When saving these diagrams, use the
-SVG format, and check the "Include a copy of my diagram". This will let
-someone open the SVG later directly from the documentation and edit it, without
-any loss in functionality or quality.
-
-The last resort is to use raster images. If they're drawings or screen
-captures, use the `PNG
-<https://en.wikipedia.org/wiki/Portable_Network_Graphics>`_ format. Consider
-compressing them with a tool like `OptiPNG <http://optipng.sourceforge.net/>`_,
-or `pngquant <https://pngquant.org/>`_. If it's a photograph, use `JPEG
-<https://en.wikipedia.org/wiki/JPEG>`_.
diff --git a/requirements.txt b/requirements.txt
index ab1a4f4..00bce7f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,11 +1,10 @@
# SPDX-FileCopyrightText: 2021 Open Networking Foundation <info@opennetworking.org>
# SPDX-License-Identifier: Apache-2.0
-Sphinx~=4.1.2
-doc8~=0.9.0
-reuse~=0.13.0
-docutils==0.16
-sphinx-rtd-theme~=0.5.2
-sphinxcontrib-spelling~=7.2.1
+Sphinx~=4.4.0
+doc8~=0.10.1
+docutils~=0.17.1
+reuse~=0.14.0
+sphinx-rtd-theme~=1.0.0
+sphinxcontrib-spelling~=7.3.2
sphinx-multiversion~=0.2.4
-sphinx-reload~=0.2.0
