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

Compare with Current View Page History

« Previous Version 37 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 EPIC
Beijing Project-level Updates

Creating or updating project-level documentation for Release 2

  
RequiredAll ProjectsAll Liaisons

DOC-197 - Getting issue details... STATUS












Interfaces

API - Structure & Tool Chain

  • Use of Swagger (required)
    Define best way to represent/visualize - RsT may not be best?
  • Containers
  • Kubernetes
HighAll Projects with APIs

René Robert

Eric Debeau

DOC-227 - Getting issue details... STATUS

API - Differentiation

  • REST APIs
  • HealthCheck APIs
  • Components APIs (eg Java class API)
HighApp Projects with APIs

DOC-200 - Getting issue details... STATUS

OpenStack Interfaces

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

Medium

OpenStack (Dave Neary, Red Hat)


Multi-VIM lixinh
Lisa Caywood

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










ONAP for Newcomers

"Welcome to ONAP" Flows and Text

Convert existing component level diagrams to high level flows and text. Include high level Architecture, as well as as typical use cases such as:  VNF Onboarding, Fault management, and Capacity management.


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

High

Project Leads


DOC-224 - Getting issue details... STATUS

ONAP "Light" for novices

ONAP "Light" version (non-coding) targeted for SEs, architects on how to use the platform

  1. Install ONAP on their local cloud environment
  2. Run Health Check
  3. Run three Use cases:  vFW, vDNS, vCPE

Documentation - Put each step into context, both what and why 

High


DOC-225 - Getting issue details... STATUS

Wiki "Sandbox"

"Sandbox" for developers to actually interact with the code

  • Install on laptops, pre-configured environment
  • Allow for coding, build and compile
  • Default IDEs
  • Does not impact live Master Branch
  • Available for hackathon

Documentation;  Need tutorial materials (videos, text, flows?)
High

Victor Morales (lead)

Helen Chen (support)


DOC-226 - Getting issue details... STATUS





VNF Reference list

Documentation and ongoing repository for integration tested VNFs (i.e. certified by ONAP for third party providers)

  • Integration Team provides list of reference VNFs
  • Need to establish template 

Future:  Establish VNF "App Store" (VNF SDK project drives ?)

Higher


DOC-231 - Getting issue details... STATUS

List of tested VNFs through BeijingHigher

Integration Helen Chen


DOC-232 - Getting issue details... STATUS

How to where to publishHigher

DOC-233 - Getting issue details... STATUS






Migrate Seed Documentation from Wiki




Migration Process / Issues

Anuj Kapoor

DOC-179 - Getting issue details... STATUS

Setting Up ONAPHigher

Integrating with ONAPHigher


Using ONAPHigherDocumentation / SDC, Policy, CLAMP, VIDGregory Glover
ArchitectureHigherArchitecture / All Projects

Documenting ONAPHigherDocumentation
Developing ONAPHigherAll Projects

GlossaryLowModeling, Architecture


















Doc Tool Chain / Utilities



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

Dev Edit RST File - Unit Test - Gerrit - Code Review/Verify Job - Gerrit Human Review - Daily CSIT - Release Integration Test

Higher

DOC-234 - Getting issue details... STATUS

RTD Feedback

  • JIRA project to report an error
  • Wiki or stack overflow Q&A
  • Simple, more accessible link tool for editing RTD pages
Medium

DOC-228 - Getting issue details... STATUS

Wiki Feedback
Establish new structure and process for:

  •     Discussion forum
  •     Submitting suggestions / feedback with existing content
Medium

DOC-230 - Getting issue details... STATUS

LF Tool Chain Documentation

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

DOC-229 - 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

DOC-235 - Getting issue details... STATUS

VNF Certification

How and when to document:

1. Certified VNFs (when that happens)

2. Certified Platform elements


VVP

DOC-236 - Getting issue details... STATUS

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

DOC-237 - Getting issue details... STATUS

Wiki vs ReadthedocsHow to best communicate guidelines on what content should be where
Thanh HaGregory Glover

DOC-238 - Getting issue details... STATUS

  • No labels