Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Attending

Andrea Visnyei Andreas GeißlerEric Debeau Thomas KulikJakob KriegRamakrishna GP Jakob Krieg Sofia Wallin Ken KANISHIMA

Topics, Notes, Status and Follow-Up Tasks

...

TopicNotes / Status / Follow-up
Upcoming milestones and release planning for docs

To be finalized Guilin Release Planning for docs

Sofia to add the basics of the documentation project as well as specific. The team will elaborate on their specific areas/content for more details. 

Encouraging everyone to add planned documentation updates to the documentation tracking page https://wikilf-onap.onapatlassian.orgnet/wiki/x/_LkLBQubT6 

Documentation guide 

Keeping this as a standing agenda point. 

To be reviewed in the next doc meeting. 

Sofia Wallin to create an Epic with relating tasks of things to do. 

 

Thomas Kulik Jakob Krieg

Thomas Kulik : Documentation Developer Guide (https://docs.onap.org/en/latest/guides/onap-developer/how-to-use-docs/index.html) extention planned for Beginners and restructure extisting Guide (

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-602
)

Jakob Krieg : Created ticked about Testing instructions 

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-

602

651

Update "Documentation improvements for end to end usage of ONAP"

@Aarna Networks

Keeping this as a standing agenda point?

Ask the team to come and give us an update every second week. 

The team to be invited to next week's meeting. 

New doc build process: Technical deep dive session

Thomas Kulik

Request for a separate technical deep dive session to explain the new doc build process (w/o submodules) and involved systems/tools and their configuration.

Maybe we like to document this also in our doc guide?

Notes:

More detailed info here,Ramakrishna GP Users guide, Operations Guide analysed.

Tickets raised and changeset created 
Tickets: 

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-650
 https://docsgerrit.releng.linuxfoundationonap.org/r/c/endoc/latest/ Let's have a read out next week. Sofia Wallinto invite Jessica Gonzalez+/110699

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-652
, should be raised on OOM project

New RST Sphinx extention for CDS Guide 

Jakob Krieg

CDS Guide in Confluence uses "Tabs" (see Modeling Concepts)

Jakob helps the CDS project to migrate the documentation to RTD and found a Sphinx extention to support tabs (extensions = ['sphinx_tabs.tabs']).
He adds it to the conf.py in the CDS repo.

When we successfully use this plugin, a suggestion would be to create a presentation for the TSC/PTL call to promote all tools and extentions in RTD to gain more acceptance to write RTD documents.

Possible content:

  • Swagger API documentation
  • Sphinx_tabs
  • Clickable Pictures (Eric)