|
Description
ONAP, the Open Network Automation Platform has transformed the telecommunications industry forever and is a key component of the 5G story. Don't worry though, this Mentorship does not require any knowledge of networking or telecommunications. It is instead about writing tools and programmatically automating the the conversion of content from one format to another.
ONAP documentation takes on 2 forms, the ONAP wiki (Confluence) and the formal documentation set (ReadTheDocs) which is in reStructuredText format. Just about all of the of the docs start out as developer notes in the ONAP wiki. The wiki content is highly uncontrolled. The formal doc set on the other hand is curated content that is highly structured. Every time there is a new release of ONAP there is content in the wiki that needs to be migrated into the formal documentation set, but it is a time consuming and mostly manual process. Because of that fact there is a lot of content that does not make its way into ReadTheDocs, which ultimately creates problems for mobile carriers that are deploying ONAP in their networks. The ability for a "one button" conversion from one documentation format to another is necessary to address this issue.
In this mentorship you will be working with the ONAP Technical Community Architect (TCA) and the Project Technical Leader (PTL) for ONAP's Documentation project to create the tooling and automation needed to help ensure that when we cut a new ONAP release the documentation on the wiki can easily be migrated to ReadTheDocs.
ONAP Wiki: https://wiki.onap.org/
ONAP ReadTheDocs: https://docs.onap.org
Well-developed learning objectives are an integral part of providing a positive internship experience and demonstrate a well-organized and robust project. Introduction to open source culture and collaboration tools should be a required learning objective for all internship projects. Additional learning objectives may include soft/hard skills the intern will learn, how the intern will be mentored or supervised, professional or networking opportunities, and etc.
Process automation for migrating/translating documentation from the ONAP Confluence to ONAP ReadTheDocs is in place and usable by the development community.
May involve forking code from an existing repo to be customized specifically for ONAP utilization.
ONAP
Students are required to be enrolled in an undergraduate program to be eligible.
Java, Groovy, RST. Knowledge of Confluence, Jira and Jenkins a plus.
Once delivered it is expected that it will be relatively static
Full-time (40 hours a week for 12 weeks during the summer) or Part-time (20 hours a week for 24 weeks starting in summer and ending in fall)
Name, email, Chat ID, company affiliation (optional)