Update

20191107:   Linux Foundation Jenkins CI tutorial: Defining Automated Jenkins Jobs for O-RAN SC Repos

Introduction

PTLs: Please include the following status information for each project

1. The list of repos that are to be included in Amber release under your project.
2. For each repo, provide the following information:
1. License Status:
   1. What license for each repo, Apache 2 or O-RAN?
   2. Whether the LICENSES.txt is included at the root of the repo and whether each code file has a license and copyright claim header?
   3. NOT including any contributing company proprietary information?
2. Code status:
   1. Is the code available (code MUST be in by code freeze date of 11/04)?
   2. Is the code build-able?
   3. Is the building and artifact generation integrated with LF Jenkins? We can mark this item as "yes" if a particular repo implements a (a) verify, (b) merge and (c) daily release job. The group maintaining a repo needs to implement this. 
3. Documentation status:
   1. Following the documentation format, structure, and template provided by DOC project?

      1. It is sufficient to have these files generate the release notes bases on docs/release-notes.rst in your repo as per https://wiki.o-ran-sc.org/display/DOC#DocumentationHome-RequiredFiles  as   ans as per these templates https://wiki.o-ran-sc.org/display/DOC#DocumentationHome-Templates :       Other files you may also generate already now if you think this can be done in the remaining Amber timeframe (deadline = Nov-13, 8am ET): docs/installation-guides.rst,  docs/release-notes.rst,  docs/developer-guide.rst , docs/api-docs.rst. (The file docs/index.rst is also needed , but coming from the next step below)as.  For Amber release the minimum requirement is the release note file. There is no need to publish README.md file from your repo in readthedocs.io . We need to figure out a clever way to maintain it in the root directory (for github& co), but also to correctly trigger the general CI job that generates documentation. You pass this item (2.c.ii) if you can successfully run "tox -e docs,docs-linkcheck" on your repo/subproject and it generates HTML that includes release notes.

   2. Documentation buildable by the DOC project?
      1. Also implement a the input for the centralized Jenkins job for pushing these to https:/that pushes the documentation to readthedocs.io (https://readthedocs.org/projects/o-ran-sc.readthedocs.io/en/latest/-doc/  (scroll down to see "Sub projects" on the right hand side)). Instructions on how to publish them to via an automatic thus centralized Jenkins job are here: Configure Repo for Documentation.  (the doc-template directory under the doc repo already contains all the necessary files).
   3. Prepared a video demo for how to build and run your project.

Documentation Home:

https://docs.o-ran-sc.org/en/latest/

Status

(Near Realtime) RICAPP

PTL: Matti Hiltunen

(Near Realtime) RIC Platform

...

NONRTRIC

PTL: John Keeney

OAM

PTL: Martin Skorupski

OCU

PTL: user-a934b

ODUHIIGH

PTL: Sachin Srivastava

ODULOW

PTL: Zhimin Yuan

INF

PTL: Xiaohua Zhang

SIM

PTL: Alex Stancu

DOC

PTL: weichen ni

...