Attending

 NICHOLAS KARIMI MUIGAI  Gergely Csatari Andrea Visnyei    Eric Debeau Andy Mayer 


TopicNotes / Status / Follow-up

AGENDA FOR TODAY


Doc Procedures

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


ArchNav Internship / SVG ArchMap

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

TASKS:

Architecture Documentation in RTD

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):

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:

Backlog Clean/Sort/Reorder

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.

Issue with RTD TOC
Doc Templates

TASKS:

Andrea Visnyei and Andreas Geissler to check current component template and improve if needed

API Documentation

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 Guideline

TASKS:

Ask users to add always the original file of grafics to the repo (plus the bitmap version of course which is used in wiki/RTD)

Istanbul Release

#doc team: Review Istanbul release notes and project content

Eric Debeau and Andreas Geissler reviewed and document the results in Istanbul Documentation

=> some comments from Andreas Geissler 

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 Geissler Eric Update conf.py file


Honolulu Maintenance Release

Andreas Geissler started to create release notes based on Jira tickets

Still a bug fix for Honolulu to be fixed and documented

TASKS:

Andreas Geissler 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)

Usage of Confluence "Tasks" in Meeting NotesPlease do not use "Tasks" in this meeting note. The meeting note is planned to be copied for the next meeting. Unfortunately all "Tasks" are also copied and a NEW INSTANCE of this tasks is created. This leads to multiple duplicated of a single tasks. 
Suggestion: Create a single "Task Page" and embed only a reference in this meeting note. Please always check upfront if this task can/must be added to the DOC JIRA issues instead. 
Other

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 Wagantallif and how we can avoid multiple duplicated tasks in the DevWiki
  • Thomas Kulikto add a chapter (question) to RTD that holds information about UseCases and supporting ONAP releases (like we have it in the Architecture Navigator)
Vacations & Upcoming Meetings
  • Thomas Kulik Vacation from 03.09.2021 until 17.09.2021
  • Andreas Geissler Vacation from 13.09.2021 until 24.09.2021 
  • next #doc meeting scheduled for 23.09.2021 
  • No labels