Skip to end of metadata
Go to start of metadata

Wiki Documents

All non-Reference documents in this wiki are governed by the following License:


Licensed under the Creative Commons License, Attribution 4.0 Intl. (the "License"); you may not use this documentation except in compliance with the License.


Source Code

All ONAP source code, including files processed by ONAP itself (such as Heat Orchestration Templates, Yang modules, etc.) are governed by the following:

/*
 * ============LICENSE_START=============================================================================================================
 * Copyright (c) 2019 <Company or Individual>.
 * ===================================================================
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
 * OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
 * ============LICENSE_END===============================================================================================================
 * 
 */

Copyright Instructions for Reference Documents 

Reference documents furnished by ONAP members must contain applicable copyright notices. For example, documents that have been furnished by AT&T are governed by the following copyright. Consult the legal department of your organization to obtain the correct wording for your contributions.

The copyright notice must appear at least once, near the beginning of the document.


Copies of License Texts:

  • No labels

4 Comments

  1. Now that we are in the year 2018 we should update the above license text to clarify how multiple years should be specified.

    For example, if I create a new Java source code file should the Copyright year(s) be 2017, 2018, 2017-18, or 2017-2018, or some other format?

    Here is a link to some discussion on this subject: https://softwareengineering.stackexchange.com/questions/130478/what-copyright-date-for-an-update-to-an-open-source-project-from-last-year?

    1. Replying to my own question...
      the Copyright for an updated project contains the string 2017-2018 and all .java and pom.xml files need to have the license text.

      This policy is exemplified by the commit https://gerrit.onap.org/r/#/c/35529/1 

  2. A few people have started adding this text to the license blocks:


    SPDX-License-Identifier: Apache-2.0


    Documentation on this meta-tag can be found at https://wiki.spdx.org/, in particular https://wiki.spdx.org/view/Technical_Team/SPDX_Meta_Tags. Similar tag values exist for creative commons, etc.


    Should we:

    • disavow this practice?
    • support this practice as optional?
    • make this a recommended practice?
    • mandate this practice?
    1. Hi Tony, thanks for raising this; I would strongly recommend this as a best practice for licensing notices.

      SPDX short-form identifiers can make it far easier to identify and automate license detection. Instead of needing to parse license notice text blocks (which can frequently get modified by accident), SPDX short-form license identifiers are unambiguous and standardized, and can start to move towards being able to "grep" for licenses. The Linux kernel and other open source projects have increasingly adopted them.

      In addition to the links you noted, more info is available at: https://spdx.org/ids

      They can also be added to existing files, without necessarily needing to remove the existing license text blocks.

      Files with ONAP source code would use the following, for Apache License version 2.0:

           SPDX-License-Identifier: Apache-2.0

      Files with ONAP documentation would use the following, for Creative Commons Attribution 4.0:

           SPDX-License-Identifier: CC-BY-4.0