...

• no manual numbering (sphinx manages this part when rendering)
• 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 refer refering to the 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