Background information

Steps to migrate to new docs

General steps look similar to OPNFV migration https://docs.opnfv.org/en/latest/how-to-use-docs/local-build-transition.html

We are working on an ONAP module to use as test to identify the exact code and changes needed to be done that fit the current ONAP structure.

Migration Status

Notes

Update as of April 07

• All Changes merged now to add each project's config
• Attached Next Steps ppt describing what we need to do next
• We are working to add a new index label that is common across all repos 
  • This is just for consistency and to make thing easier
  • Example: https://gerrit.onap.org/r/c/oom/offline-installer/+/105199/2/docs/index.rst
  • All changes: https://gerrit.onap.org/r/q/owner:releng%252Blf-jobbuilder%2540linuxfoundation.org+status:open
  • Need to ask the team if we can mass merge these for making it easier
• Internal links should be converted to intersphinx ones
  • Example: https://gerrit.onap.org/r/c/doc/+/105175
  • We are looking into how to make this task fast and put some instructions on what to do so that we can have some volunteers helping
  • There are aprox 300 links to fix

Display impact detected on https://onap-doc.readthedocs.io/

• The screen to display the content (div .wy-nav-content) is limited to 800px for the various projects  (default CSS configuration by Sphinx) while the previous value was fixed to unlimited as configured in ribbon.css => https://git.onap.org/doc/tree/docs/_static/css
  

• Need to align the Documentation project CSS with project CSS. Currently, there is no CSS in the various project directory while the conf.py includes a css link cf https://git.onap.org/oom/tree/docs/conf.py and this CSS file is not part of the project
  def setup(app): app.add_stylesheet("css/ribbon_onap.css")