Attending
NICHOLAS KARIMI MUIGAI Andreas Geissler Thomas Kulik Kenny Paul Timo Perala
Topic | Notes / Status / Follow-up |
---|---|
AGENDA FOR TODAY | |
Doc Procedures | Procedure "P01: Create documentation for an ONAP main release" is currently under development by Thomas Kulik TASKS:
|
ArchNav Internship / SVG ArchMap |
TASKS:
RESULT:
|
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) TASKS:
|
Backlog Clean/Sort/Reorder |
has 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 | TASKS: Andrea Visnyei / Thomas Kulik check RTD TOC for https://docs.onap.org/en/latest/guides/onap-developer/how-to-use-docs/templates.html |
Doc Templates | TASKS: Andrea Visnyei and Andreas Geissler to check current component template and improve if needed |
API Documentation | TASKS: Kenny Paul , Eric Debeau Session with Andy Mayer needed to clarify how we continue on the API documentation (swagger). The API docs are part of the ARC docs. See also in DevWiki. NICHOLAS KARIMI MUIGAI join Kenny in the discussion with Andy Mayer . See also in Swagger in RTD Postponed until Eric Debeauis back from vacation. |
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 | TASKS: #doc team: Review Istanbul release notes and project content; extra session required; to be planned. |
Usage of Confluence "Tasks" in Meeting Notes | Please 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:
|
|
| |
Vacations & Upcoming Meetings |
|
| |||||||||||||
NOT DONE DUE TO TIME CONSTRAINTS | |||||||||||||
Open gerrit issues |
| ||||||||||||
Open jira tickets |
TASKS: Thomas Kulik : Propose that every project should use tox.ini (incl. link check)? Create a new Epic for this? conf.py must be updated as well! | ||||||||||||
Sprints |
TASKS: Thomas Kulik : Ask for DT-internal help to set up this structure. Eric Debeauand Andreas Geisslerwill help as well. | ||||||||||||
Guide Doc Dev System |
| ||||||||||||
OPTIONAL (IF TIME ALLOWS) | |||||||||||||
All | Collection of topics not started TASKS:
| ||||||||||||
Objectives for upcoming releases | Jira ticket walkthrough,
The team will investigate further with the OOM team on how to enable a non-voting job for warnings. TASKS: Check why closes ticket show up even when the filter is set to "Open" or "In progress" | ||||||||||||
Honolulu Maintenance Release |
| ||||||||||||
Architecture documentation | TASKS:
Documenting ONAP Architecture (New) | ||||||||||||
Link management in RTD Eric Debeau | Many links are managed in RTD
There is a problem when a documentation linkes to a repo => the branc is not indicated. As result, the link points to the latest release Propostion to provide guidelines to be then presented for PTL Many links are broken => need to include a test in JJB and provide information about broken links Feedback has been given, positive output. Next step, bring to PTL Sill required from the project to test | ||||||||||||
Create project docs manually with gerrit in case a project has branched but not changed any file in the new branch afterwads | Andreas Geissler showed a solution to create project docs manually within gerrit in case a project has branched but not changed any doc file in the new branch afterwards. There are extended right in gerrit needed (" |