...
- Create and maintain documentation targeted to ONAP user audiences and the tasks they perform. For example:
- a platform developer pulling, building, running, hacking and pushing source code;
- an administrator installing, configuring, and monitoring an ONAP instance;
- a designer or tester creating, validating, and delivering service models;
- a VNF developer designing, testing, and certifying a VNF for use on ONAP
- a Service Provider using VNF Requirements as prototype text for RFPs to acquire VNFs to run in an ONAP context
- ... others as required for release plans or ONAP committees
- Establish and maintain a tool chain that supports the integration of documentation source material from all ONAP projects and builds documentation artifacts for each release.
- Establish a process to recognize documentation source material and final documentation dependencies in the release plan, end to end tests, and /or CI/CD to insure these deliverables are created early when needed in a release cycle and remain current with changes made in other software projects.
- Enable technical writer (contributors) for each release to create and integrate content based on overall release requirements.
- Benefits include users quickly understand how to do required tasks, documentation is efficiently created and is in sync with the software in a release.
...
- Describe the functionality to be provided by the project.
- Documentation artifacts for an ONAP release that contain
- original content created by contributors to the documentation project and
- integrate source material from any project that the documentation depends to be consistent with an ONAP release.
- CI/CD Documentation Tool Chain
- The tool chain to create document artifacts will include use gerrit, jenkins, and nexus the same as software projects and add specific tools appropriate for documentation.
- Where published documentation depends on source in any repository, the tool chain will support the automated integration - e.g. to propagate changes in APIs into the documentation.
- Documentation artifacts for an ONAP release that contain
- Please provide the full intended scope of the project; not just what is intended for the project's first release.
- The first release establishes best practices and patterns for managed documentation as well as the documentation for ONAP release 1.
- Subsequent releases maybe required for all projects to comply with best practices, to complete content for all audiences, to address how documents might be tailored or translated for use in different ONAP instances, etc.
- Specify any interface/API specifications proposed
- TBD the documentation tool chain selected may impose some requirements on how source material is structured in repositories that will be integrated.
- Please provide the full intended scope of the project; not just what is intended for the project's first release.
- Identity a list of features and functionality will be developed.
- Documentation managed with the same pattern as source code including gerrit, jenkins, artifacts published in nexus or readthedocs.org, etc.
- Output documentation format TBD - likely static html and .pdf versions with hyperlinks between the different documents as appropriate..
- Depending on the volume of documentation, some indexing/ search capabilities may be provided.
- Identify what is in or out of scope. During the development phase, it helps reduce discussion.
- In scope - Best practice tool chain and CI/CD pattern for creating documentation, Release 1 documentation.
- Out of scope - Training is not part of this project
...
Resources:
- Primary Contact Person: Greg Glover, Rich Bennett
- Names, gerrit IDs, and company affiliations of the committers
- Rich Bennett, rb2745@att.com, AT&T
- Timo Perala, timo.perala@nokia.com, Nokia
- Greg Glover, gg2147@att.com, AT&T
- Kevin Scaggs, ks0567@att.com, AT&T
- Steven Wright, sw3588@att.com, AT&T
- James Yang, james.yangliu@huawei.com, Huawei
- To Be Added, , Nokia
- Names and affiliations of any other contributors
- TBD based on final requirements for Relase 1
- Project Roles (include RACI chart, if applicable)
...
Repo names:
docs
docs/tools
docs/source/admin
docs/source/design
docs/source/test
docs/source/platformdev
docs/source/vnfdev
docs/source/serviceprovider
Lifecycle State: proposal
Primary Contact:
Project Lead:
mailing list tag [docs]
Committers:
rb2745@att.com
timo.perala@nokia.com
gg2147@att.com
ks0567@att.com
james.yangliu@huawei.com
...