You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

This page lists all documentation-related projects that have been proposed as part of the Beijing release

Project NameDescriptionPriorityProject Owner(s)Doc Liaison(s)JIRA  Index Issues/Tasks
CONTENT-RELATED




OpenStack InterfacesStrategic view of where and why OpenStack API's are used in ONAP, interface definitions and expectations; AI&I, DCAE (gathering information from the platform), Multi-VIM, APP-C, and SDN-C (asking the platform to do things/put itself in a certain state).HighOpenStack / TBDTBD


Flow DiagramsConverting to text existing flow diagrams describing each component and where the hand-offs happen, including corresponding videos. Include VNF onboarding, Fault management, Capacity management.
Istio's Concepts page breaks down high level concepts https://istio.io/
HighProject Leads
Wiki "Sandbox" for newbiesCreate higher level sandbox for developers, SEs, architects to see E2E system / Cross component interactions
Issues:
    How complete does the Wiki version need to be?
    Blocked by need for continuous deployment servers
High

Integration? Helen Chen ?



VNF ReferenceList of tested ONAP VNFs
(where should it go - include ONAP.org)
High

Integration? Helen Chen ?



Wiki Conversion & Migration




Setting Up ONAPHigh


Integrating with ONAPMedium

Integration Helen Chen ?



Using ONAPHighDocumentation / SDC, Policy, CLAMP, VIDGregory Glover
Architecture - Minor edits / table conversionMediumArchitecture / All Projects

Documenting ONAPMediumDocumentation

Developing ONAPHighAll Projects

External Installation OptionsInstallation / Lab options provided by:
- Vendors (to be listed via request to mailing list)
- Linux Foundation (if any available solution is ready)
- ONAP Community (e.g. Orange OpenLab should be open soon, also Eric set up individual VM on Orange public cloud for APPC or SDNC to let people play with the DG, API…
MediumONAP.orgLisa Caywood
API's    Differentiate:
    -  REST APIs
    -  HealthCheck APIs
    -  Components APIs (eg Java class API)
MediumAll Projects

Restructure existing content Restructure / Remap existing content to Developer and SDK templates  Low


GlossaryMigrate Wiki content to RsT and expand content to include:
-  VNF Information Modeling terms
-  Indexing / tagging to enable Searching
LowModeling / Architecture







UTILITIES / TOOLS




Automation/Verification

  • Doc8+/- Coala Code Policies
  • Spelling
  • Grammar
  • Editorial / Usability
  • Sphinx directives
  • Integrity of Glossary/Info Model
  • Integrity of sphinx toctree
  • Integrity of external references
  • Acceptable file types
  • CI/CD repo integration
  1. Dev Edit RST File
  2. Unit Test
  3. Gerrit - Code Review/Verify Job
  4. Gerrit - Human Review
  5. Daily CSIT
  6. Release Integration Test



RTD Feedback

• JIRA project to report an error

• Wiki or stack overflow Q&A and/or

MediumDocumentation

Wiki Feedback


Establishing new structure and process for:

  •     Discussion forum
  •     Submitting suggestions / feedback with existing content


Low

RTD Edit ToolSimple, more accessible tool for making changes on pagesLow

Documentation




LF Tooling / Utilities

How to:

  •     Gerrit guide
  •     Guidelines (Builds, etc.)
  •     Utilities:  Jenkins, Conversion tools (e.g. LFPandocs)
LowLF






PROCESS ISSUES




Branching GuidelinesHow and when to branch
Release Manager Gildas Lanilis

VNF Certification

How and when to document:

1. Certified VNFs (when that happens)

2. Certified Platform elements


VVP

VideosManaging and tracking what and where videos are being posted
Lisa CaywoodGregory Glover






  • No labels