Versions Compared

Key

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

Overview

This page is to provide detail on the contribution process for CPS.

Joining the ONAP Community 


Development Procedures and Policies

Code

Repo

Repos

Initial Seed Code Contribution

Code Requirements

  1. Copyright included in each file.  Apache 2 for coding files.
    1. The Copyright line for contributing organization inserted or updated reflecting the contribution year.
  2. A LICENSE.txt file placed at the root of the repo to provide umbrella coverage.
  3. Unit testing coverage > 55% for POC
  4. We will follow ONAP Recommended Software Development Best Practices: Developer Best Practices

Kanban board

https://jira.onap.org/secure/RapidBoard.jspa?projectKey=CPS&rapidView=228

JIRA Status Updates

Move To

When

In-progress

The moment you start working on it.

Submitted

The review is merged, merge & CICD jobs are successful.

ClosedDocumentations are updated. Complete demo to team.

Committer Strategy

  • Each review requires 2 committers to +1 and +2.
  • A +2 from committer or PTL have the permissions to merge code.

Code Submissions

  • Any checkstyle issues must be fixed in current review.
  • Code must be covered by tests.
  • We are currently in the process of setting up sonarqube to check our code coverage. Please use the sonarqube plugin for now to measure coverage. To setup sonarqube see dev setup guide: Setting Up Your Development Environment#LocalSonarQubeSetup
  • Mark the review as WIP if it is not ready for review. 
  • Commit message must be in the following format: 

Comment explaining what is the purpose of the code.
Jira Link: https://jira.onap.org/browse/CPS-1

Issue-ID: CPS-1

See also: Commit Messages

Java Code Required Practices

Java code style

Jenkins Job 

ONAP uses Jenkins based CICD tool chain.  However, contributors are only given read access to the Jenkins servers.  All jobs are created by automatic generation from JJB definitions. 

https://jenkins.onap.org./view/cps/

Bug reporting

https://jira.onap.org/secure/RapidBoard.jspa?rapidView=228&projectKey=CPS&view=planning&issueLimit=100


Vulnerability report process

If you find any vulnerability please email the security contact with the information that you have.

The security contact is ; toine.siebelink@est.tech

We will give credit to anyone who reports a vulnerability so that we can fix it. If you wish to remain anonymous instead, please let us know and we will respect that.

Documentation

https://docs.onap.org/en/latest/index.html