Versions Compared

Version Old Version 18 New Version Current
Changes made by

Thomas Kulik

Andreas Geißler

Saved on

Key

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

Virtual Event

We are taking a break, back again at 13:30 CET.

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

...

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
CETMarch 11th10:00-17:00

Sofia Wallin

EDT


PST


Logistics:

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

...