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

Compare with Current View Page History

« Previous Version 15 Next »

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

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




Beijing Release Content

Work related to creating or updating documentation for Release 2

  
HighAll ProjectsAll Liaisons
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).High

OpenStack ?

Multi-VIM xinhuili

DOC-202 - Getting issue details... STATUS DOC-211 - Getting issue details... STATUS

Welcome to ONAP  Flows and Text

Convert existing component level diagrams to high level flows and text. Include VNF Onboarding, Fault management, and Capacity management.

One example is Istio's Concepts page: https://istio.io/docs/concepts/

High

Project Leads

Red Hat (Dave Neary) ?


Wiki "Sandbox" for novicesCreate 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 Reference

Documentation structure for tested VNFs

Issue:  where should it go - include i.e. ONAP.org

High

VVP Steven Wright

ONAP Marketing



Migrate Wiki Documentation




General Migration Issues


DOC-63 - Getting issue details... STATUS

Setting Up ONAPHigh


Integrating with ONAPMedium

Integration Helen Chen ?



Using ONAPHighDocumentation / SDC, Policy, CLAMP, VIDGregory Glover

DOC-172 - Getting issue details... STATUS DOC-179 - Getting issue details... STATUS

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

DOC-200 - Getting issue details... STATUS DOC-85 - Getting issue details... STATUS

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

DOC-148 - Getting issue details... STATUS DOC-105 - Getting issue details... STATUS DOC-94 - Getting issue details... STATUS DOC-2 - Getting issue details... STATUS

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

DOC-154 - Getting issue details... STATUS







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
Medium

LF Amar Kapadia ? /

Documentation

DOC-160 - Getting issue details... STATUS DOC-81 - Getting issue details... STATUS

RTD Lifecycle Feedback

• JIRA project to report an error

• Wiki or stack overflow Q&A

Medium

LF Amar Kapadia ? /

Documentation


Wiki Feedback


Establishing new structure and process for:

  •     Discussion forum
  •     Submitting suggestions / feedback with existing content


Low

RTD Edit Tool

Simple, more accessible link tool for making changes on RTD pages

LowDocumentation

LF Tooling / Utilities

How to:

  •     Gerrit guide
  •     Guidelines (Builds, etc.)
  •     Utilities:  Jenkins, Conversion tools (e.g. LF Pandocs)
LowLF Thanh Ha

DOC-201 - Getting issue details... STATUS







PROCESS ISSUES




Branching Guidelines

Specify how and when to branch Beijing

Provide clear dates to expectations to PTLs - goal is to finalize Beijing more quickly than it took for Amsterdam


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