Versions Compared

Key

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

DRAFT PROPOSAL FOR COMMENTS

The content of this template is expected to be fill out for M1 Release Planning Milestone.

...

Project NameEnter the name of the project
Target Release NameAmsterdam
Project Lifecycle StateIncubation
Participating Company AT&T, Amdocs, Huawei, Nokia, China Mobile, ZTE, Accenture

Scope

What is this release trying to address?

...

Deliverable NameDeliverable Description
doc/index.rstMaster

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/tools/*Scripts used to collect, compose, validate source documentation material and publish final form documentation
doc/<source directories>Source directories and sub-directories source/<repository>

Repositories as needed to

  • align with the overall documentation index
  • 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 use uses multiple software components)
  • represent content that is being maintained by another software project that will be integrated int (eg. how to install a software component)

Sub-Components

...

  • reflect different committer expertise and responsibility for a class of documentation (eg. guide for a developer, user, operations)
TBD (onap.readthedocs.io, nexus.onap.org raw site)Published release documentation

Sub-Components

All components are described as source deliverables above and/or will be identified by:

  • inclusion in the master index with a reference to another project repository/index file and link from a JIRA story for the other projects to the DOC project story 
    Jira Legacy
    serverSystem Jira
    serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
    keyDOC-17

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

...

  • ci-management
  • Any project that contains a portion of the documentation source referenced in final documentation set.
  • A documentation publishing site (eg. readthedocs.io, Nexus raw site)


Architecture

Sections below to be provided after tool chain comparison/discussion

High level architecture diagram

At that stage within the Release, the team is expected to provide more Architecture details describing how the functional modules are interacting.

Block and sequence diagrams showing relation within the project as well as relation with external components are expected.

Anyone reading this section should have a good understanding of all the interacting modules.

Gliffy
nameDOC Architecture for M1

API Incoming Dependencies

List the API this release is expecting from other releases.
Prior to Release Planning review, Team Leads must agreed on the date by which the API will be fully defined. The API Delivery date must not be later than the release API Freeze date.

Prior to the delivery date, it is a good practice to organize an API review with the API consumers.

API NameAPI DescriptionAPI Definition DateAPI Delivery dateAPI Definition link (i.e.swagger)
To fill outHigh level description of the APITBDDate for which the API is reviewed and agreedTo fill outLink toward the detailed API description

...

Risk identifiedMitigation PlanContingency Plan
Scope of release requirements

Complete and Interlock on Release Index

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-16

To fill outTo fill outTo fill out
Availability of contributors

Create/Link JIRA Contribution Stories to

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-17


Alignment on the Minimum Viable Tool Chain

Create early, partial content, end to end  example

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyDOC-8


Resources

Fill out the Resources Committed to the Release centralized page.

Release Milestone

...