Versions Compared

Version Old Version 2 New Version Current
Changes made by

Sofia Wallin

Andreas Geißler

Saved on

Key

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

Virtual Event

Location - Virtual partcitation

This event will be be a virtual hacking session focusing on the Frankfurt Release. The call with be open throughout the day of Wednesday 11th (so far CET).

...

  • On-going Docs JIRA tickets
  • Project documentation for the Dublin Frankfurt release
  • Learn more about how to work with documentation
  • Submodule removal 
  • <addme>


TimeNameTopic/taskOutcome


Andreas Geißler Thomas Kulik

Default structure for ONAP functional/non-functional modules/projects (to easily build views later on; context here is the discussion with Chaker)

1. develop a RST template for module documentation (maybe a task for technical writers)

 a) proposed structure for Modules:

  • Architecture
  • Offered APIs
  • Consumed APIs
  • User Guides
    • Human Interfaces
  • Administration and Operation Guides
    • Installation
    • Configuration
    • Logging
  • Developer Guides
  • Release Note

b) define a "label template" for each chapter to create cross-reference to.

2. develop "landing pages" (as in Chacker's proposal) with clickable figures to jump to the right content in

  • Architecture
    • Link to E2E Architecture and Module Architecture
  • User Guides
    • Link to E2E Guides and Module guides
  • Administation and Operation
    • Link to E2E Guides and Module guides
  • Developer Guides
  • Security

possible further enhancements:

  • define "Tags" to define filter criteria → needs to be checked

Andreas Geißler Thomas Kulik

Migration/Deprecation of docs (Wiki/RTD) (plus helper script in doc/tools)
  • Actual status and plans: /wiki/spaces/Deprecated/pages/15859782
  • Start with the following Wiki pages:
    • Documenting ONAP
    • Architecture
    • Developing ONAP (partly)
    • Setting up ONAP (partly)
    • Integrating with ONAP
    • Supporting Tools
  • Take support by the community to decide on content and migration
  • tools currently stored in the doc/tools repo will be moved to the doc repo (under doc/tools directory) (see topic below)

Thomas KulikReduction of RST warnings (plus helper script in doc/tools)
  • tools currently stored in the doc/tools repo will be moved to the doc repo (under doc/tools directory)
  • Sofia will check if doc/tools repo is still needed and remove it if possible
  • Repo info in wiki will be updated accordingly
  • reduction of warnings in rst files is ongoing (start: 1650 warnings, currently:750 warnings)

Andreas GeißlerPossible topics for technical writers hired by LFN
  • Should support the whole ONAP community 
  • Can create templates (see topic 1, release notes templates) 

Thomas Kulik Eric Debeau Sofia Wallin

Jira Ticket Review

Walkthrough of all doc tickets in Jira
























Date and Time

Time zoneDateTimeParticipants
CETApril 17thMarch 11th0910:00-1617:00

Sofia Wallin

EDT


PST


Logistics:

Join Zoom Meeting
https://zoom.us/j/5969891148

Meeting ID: 596 989 1148

One tap mobile
+16699006833,,5969891148# US (San Jose)
+19292056099,,5969891148# US (New York)

Dial by your location
+1 669 900 6833 US (San Jose)
+1 929 205 6099 US (New York)
Meeting ID:

...

TBA596 989 1148
Find your local number: https://zoom.us/u/aciqL3YTpP