| Topic | Notes / Status / Follow-up |
|---|
| |
| Open gerrit issues | |
| Open Jira tickets | - We went through the open Jira issues for Honolulu release
- 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 | - should Should we structure our (doc) work in sprints?
| Wiki 2.0 - New Task Force | Led by Timo Perala, Ranny Haiby. Goal: Redefine the structure of the ONAP wiki, to identify the relevant pages, to create onboarding for newbies, etc.Timo Perala Taskforce is started. A proposal for a community vote can be found here: What Do You Think We Should Improve? . Please add your ideas to the proposal |
| New Doc Tracking Page | - Now active for Istanbul release. See
|
| Guide Doc Dev System | currently - Currently under development (txt version available; transfer to rst
- at 90%); Timo Perala volunteers for review.
- 19.05.2021: The reviewed version (ready for submit) can be found here
|
| Upcoming Meetings | - 13.05.2021: No meeting due to public holiday.
- 20.05.2021 and 27.05.2021: Thomas Kulik Vacation.
|
OPTIONAL (IF TIME ALLOWS) |
|
| All | Collection of topics not started - Dedicated repo for every subcommittee (that creates and maintains formal ONAP documentation)? To be discussed.
- Fix ReadTheDocs starting page to the last official release (and not 'latest')
- add tracking information to the new docs tracking page (currently WIP!!!) To be discussed.
|
- Objectives for Honolulu (and onwards)
| Jira ticket walkthrough, | Jira Legacy |
|---|
| server | System Jira |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| maximumIssues | 200 |
|---|
| jqlQuery | project = DOC AND ( status = "Open" OR status= "In Progress" ) |
|---|
| serverId | 4733707d-2057-3a0f-ae5e-4fd8aff50176 |
|---|
|
The team will investigate further with the OOM team on how to enable a non-voting job for warnings. - Check why closes ticket show up even when the filter is set to "Open" or "In progress"
|
- Guilin Maintenance Release
| All done for the doc project (date in the release note might need to be updated). Still lacking some project updates |
- Architecture documentation
| For future collaboration and facilitation we will ask for a time slot in the arch subcommittee meeting to inform and educate how to work with docs. https://gerrit.onap.org/r/c/doc/+/115497 |
| David McBride will join to discuss this further. Active projects vs maintenance projects. A weekly meeting was scheduled to allign doc topics with RelMgr |
| Many links are managed in RTD - local links within a repo
- inter-project links using inter-links from sphinx
- links to code repo
- external links to web sites
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 Geißler 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 (" |