Versions Compared

Key

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

...

  1. Update project-level documentation for Beijing Release requirements
  2. Improving the Usability of the Platform:
    • Establish consistent tool chain and standards guidelines for API documentation
    • Create introductory documentation Welcome to ONAP and "sandbox" functionality for novices to ONAP
    • Refine and harden Automate verification process in the CI/CD Documentation tool chain and processes initially established in Amsterdam
    • Migrate seed documentation currently in the wiki or gerrit that is being maintained by approved projects
    • Refine / expand current documentation for VNFs, OpenStack interfaces, UIs, and LF Tool Chain
    • Establish feedback mechanisms in Wiki and/or Readthedocs to improve documentation

...

  1. Publish a finished set of formal change-controlled documentation where it can be easily referenced by for any user audience that is working with the ONAP Beijing release.
  2. Novices
  3. Establish a consistent method for documenting APIs
  4. Create welcoming documentation and a place to play for novices to ONAP
  5. Create a way for users to provide feedbackCross-project Integration / Views  

Minimum Viable Product

Final documentation for ONAP Beijing Use Cases

...

Jira
serverONAP JIRA
columnssummary,type,created,updated,due,reporter,priority,status
maximumIssues20
jqlQueryProject = Doc and type = EPIC and status = Open
serverId425b2b0a-557c-3c0c-b515-579789cceedb

...

Indicate the outcome (Executable, Source Code, Library, API description, Tool, Documentation, Release Note...) of this release.

Required (Level 1)Deliverable Description
doc

Source Repository with a master index for all documentation in an ONAP Release in TBD( .rst, .md, or other) format.
Each index file may contain source content and references to other index files within the doc repo directory structure, other repositories with the doc project (eg. doc/source/userguide), and/or other project repositories.

doc/toolsScripts used to collect, compose, validate source documentation material and publish final form documentation
doc/source/<repository>

Repositories as needed to

  • store content that integrates documentation across the platform and/or focuses on users audiences and tasks that a software project does not need to be aware of (eg. a task that uses multiple software components)
  • reflect different committer expertise and responsibility for a class of documentation (eg. guide for a developer, user, operations)
Beijing Project-level UpdatesPublished release documentation for all Beijing projects
Stretch Goals (Level 2)Deliverable Description
Content Initiatives
  • Published Guidelines for API documentation
  • Published "Welcome to ONAP" and "sandbox" functionality
  • Migrated seed documentation currently in the wiki or gerrit
  • Refined / expanded documentation for VNFs, OpenStack interfaces, UIs, and LF Tool Chain
Tool Chain Initiatives
  • Tool Chain established for API documentation
  • Refined and hardened CI/CD tool chain and processes
  • Feedback mechanisms implemented in Wiki and/or Readthedocs
TBD (onap.readthedocs.io, nexus.onap.org raw site)Published release documentation

Sub-Components

List all sub-components part of this release.
Activities related to sub-components must be in sync with the overall release.

Sub-components are repositories and are consolidated in a single centralized place. Edit the Release Components name for your project in the centralized page.

...

Risk identifiedMitigation PlanContingency Plan
Scope of release requirementsComplete and Interlock on Release IndexTo fill out
Availability of contributorsCreate/Link JIRA Contribution Stories toRecruit resources as neededAdjust scope & deliverables accordinglyAlignment on the Minimum Viable Tool ChainCreate early, partial content, end to end  example
  • Resources

Fill out the Resources Committed to the Release centralized page.

  • Release Milestone

The milestones are defined at the Release Level and all the supporting project agreed to comply with these dates.

...