Page Comparison

Procedure "P01: Create documentation for an ONAP main release" is currently under development by Thomas Kulik

A dedicated procedure related for Maintenance Release: P02: Create documentation for an ONAP maintenance release (doc project team) has been created

• Internship of Nicholas Karimi has come to an end
• ArchNav will be maintained by Chaker Al-Hakim 

No update on that topic. Still discussion to open source the code

TASKS:

• Check with Chaker Al-Hakim

There is the need to move finalized ONAP architecture documentation from DevWiki to RTD. Especially the following section are from interest (examples from the Istanbul release):

• Architecture Map
• Component Descriptions (incl. sub-pages)

Evaluation started; Confluence has now a new functionality to export a page to markdown format; lets see if/how this can help (attachements unfortunately are not included)

Pending pach: https://gerrit.onap.org/r/c/doc/+/123946. Eric Debeau did some comments

TASKS:

• Andrea Visnyeito support the process of transferring the information from DevWiki to RTD:
• Thomas Kulikto support here and check how this process can be automated. Especially the embedded draw.io diagrams (special confluence macro) may cause problems if we use confluence2md to export pages). Shedule a meeting with Chaker Al-Hakimand team.
• Chaker Al-Hakimand team to support the transfer.
• Chaker Al-Hakim, Thomas Kulikand teams to create a process to transfer information to RTD also for upcoming releases.
• DOC team will migrate 3 to 5 pages / the remaining pages are in the responsibility of the ARC team
• Gergely Csatari did a patch for: https://gerrit.onap.org/r/c/doc/+/123946He will test the scripts on Components wiki page: 

  https://lf-onap.atlassian.net/wiki/display/DW/Istanbul-R9+ONAP+Architecture+Component+Description

  
  

We will do it in jira!

TASKS:

Thomas Kulikhas prepare a deduplicated and sorted list of open tasks. Next step is to go through the list and remove outdated/unwanted entries.

TASKS:

Andrea Visnyei / Thomas Kulik check RTD TOC for https://docs.onap.org/en/latest/guides/onap-developer/how-to-use-docs/templates.html

TASKS:

Andrea Visnyei and Andreas Geißler to check current component template and improve if needed

Andy Mayer

presentation, Developing ONAP API Documentation

TASKS:

Eric Debeau

to check available API documentation in RTD and how to update with material proposed by Andy Mayer 

Andy Mayer will participate to the next doc meeting

#doc team: Review Istanbul release notes and project content

Eric Debeau and Andreas Geißler reviewed and document the results in Istanbul Documentation

=> some comments from Andreas Geißler 

Some projects to move on

"Unmaintained" mode (ExternalAPI, VID)

TASKS:

Eric Debeau Still clarification required for Architecture section (Architecture subcommittee)

Eric Debeau  Modeling update to be checked

Eric Debeau

clarification on MSB status

Eric Debeau  Andreas Geißler Eric Update conf.py file

Andreas Geißler started to create release notes based on Jira tickets

Still a bug fix for Honolulu to be fixed and documented

TASKS:

Andreas Geißler will ask SO and CDS projects to

finalize the Docker creation and

documentation

it is also important to document the process (later on used in a procedure) => P02: Create documentation for an ONAP maintenance release (doc project team)

TASKS:

• Kenny Paulto check if we can get support (eg. additional internship) to extend the capabilities of the "confluence2md" tool
• Kenny Paulto discuss with Jessica Gonzalezif and how we can avoid multiple duplicated tasks in the DevWiki
• Thomas Kulikto add a chapter  to RTD that holds information about UseCases and supporting ONAP releases (like we have it in the Architecture Navigator)

• Thomas Kulik Vacation from 03.09.2021 until 17.09.2021
• Andreas Geißler Vacation from 13.09.2021 until 24.09.2021 
• next #doc meeting scheduled for

• 23.09.

• 2021