Participants

Antitrust policies

Computing Force Network Jie Niu

Doc conversion Cedric Ollivier

Our golden rules:

no manual numbering (sphinx manages this part when rendering)
leverage :numref: https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-numref for figure refs
no unicode character (it would break PDF rendering)
use " and '
double check blank chars if you leverage Github editor (I would rather recommend any IDE)
check the gate before merging https://build.opnfv.org/ci/view/cntt/
enable doc8 without any exception and linkcheck

PDF rendering is ongoing

wrapping to 120 could easily break the PDF rendering (80 could too in specific cases)
please leverage table and list-table directives which automatically adds the captions https://docutils.sourceforge.io/docs/ref/rst/directives.html
to tune the LaTeX theme and to make the PDF closer to the GSMA one
WIP:
- https://artifacts.opnfv.org/ra1/jenkins-cntt-tox-ra1-1414/anuketopenstackbasedreferencearchitecture.pdf (RA1)
- https://artifacts.opnfv.org/rc2/jenkins-cntt-tox-rc2-1414/anuketreferenceconformanceforkubernetesrc2.pdf (RC2)

Please check any inconsistency between PDF/HTML and GSMA

to include abbrevations, etc. instead of refering to a common rst
to add the missing GSMA sections in our source code

One tag for the whole CNTT project ? Do we split the git repository?

intersphinx defacto fails if RM and RA1 are not aligned
ideally we should add one tag per stream published in GSMA

AoB

None