diff options
author | Rich Bennett <rb2745@att.com> | 2017-10-18 15:27:52 -0400 |
---|---|---|
committer | Rich Bennett <rb2745@att.com> | 2017-10-18 15:36:43 -0400 |
commit | c5995662a3bbca2f216264c1717e042d7ad10f4c (patch) | |
tree | 5739f6854aac6b57f5a0a64df4f40cdc4b41ccdf | |
parent | da406d6c1fc8719ca54777b6a4c583d2910fd98d (diff) |
Update Copyright and Licensing markings
Add footer reference to CC4 and make Copyright 2017 ONAP
Modify how to create documentation guide to describe appending copyrights on update contributions.
Update Collections Titles
Exclude aaf until source rst files are corrected for the next release.
Change-Id: I3ed26910b2bbb7a15c7c2865e40ff1e5545a00ff
Issue-ID: DOC-102
Signed-off-by: Rich Bennett <rb2745@att.com>
-rw-r--r-- | docs/conf.py | 7 | ||||
-rw-r--r-- | docs/guides/onap-developer/architecture/index.rst | 140 | ||||
-rw-r--r-- | docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst | 6 | ||||
-rw-r--r-- | docs/release/index.rst | 4 | ||||
-rw-r--r-- | docs/release/repolist.rst | 11 | ||||
m--------- | docs/submodules/so/libs.git | 0 | ||||
-rw-r--r-- | docs/templates/collections/platform-component.rst | 4 | ||||
-rw-r--r-- | docs/templates/collections/sdk.rst | 4 |
8 files changed, 91 insertions, 85 deletions
diff --git a/docs/conf.py b/docs/conf.py index 4fb3f416d..f4fc0e077 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -65,7 +65,9 @@ master_doc = 'index' # General information about the project. project = u'' -copyright = u'2017, ONAP. Licensed under CC BY 4.0' +copyright = u'2017 ONAP. Licensed under Creative Commons Attribution 4.0 International License' + + author = u'Open Network Automation Platform' # The version info for the project you're documenting, acts as replacement for @@ -93,7 +95,8 @@ language = None # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns = [ - '_build' + '_build', + 'submodules/aaf' ] # The reST default role (used for this markup: `text`) to use for all diff --git a/docs/guides/onap-developer/architecture/index.rst b/docs/guides/onap-developer/architecture/index.rst index f7cae3858..84c93c051 100644 --- a/docs/guides/onap-developer/architecture/index.rst +++ b/docs/guides/onap-developer/architecture/index.rst @@ -4,9 +4,9 @@ Architecture ============ .. note:: - Some high level groupings are introduced below with references to project/repo index. - As more information is provided by each project these references will shift lower to - to include only certain sections from each project. For example, the project architecture section. + Some high level groupings are introduced below with references to project/repo/docs/architecture.rst or similar architecture references. + As more information is provided by each project in a docs/architecture.rst file, it will appear here. Show source to see the references + in each grouping. Models ------ @@ -15,7 +15,7 @@ Models :maxdepth: 1 :titlesonly: - ../../../submodules/modeling/modelspec.git/docs/index + Model Specifications <../../../submodules/modeling/modelspec.git/docs/ONAP release 1 spec/index> User Interfaces --------------- @@ -24,18 +24,18 @@ User Interfaces :maxdepth: 1 :titlesonly: - ../../../submodules/clamp.git/docs/index - ../../../submodules/cli.git/docs/index - ../../../submodules/sdc/jtosca.git/docs/index - ../../../submodules/sdc/sdc-distribution-client.git/docs/index - ../../../submodules/sdc/sdc-docker-base.git/docs/index - ../../../submodules/sdc/sdc-titan-cassandra.git/docs/index - ../../../submodules/sdc/sdc-tosca.git/docs/index - ../../../submodules/sdc/sdc-workflow-designer.git/docs/index - ../../../submodules/sdc.git/docs/index - ../../../submodules/usecase-ui.git/docs/index - ../../../submodules/vid/asdcclient.git/docs/index - ../../../submodules/vid.git/docs/index + CLAMP - Closed Loop Automation Platform <../../../submodules/clamp.git/docs/index> + CLI - Command Line Interface <../../../submodules/cli.git/docs/architecture.rst> + SDC - Service Design and Creation <../../../submodules/sdc.git/docs/architecture.rst> + ../../../submodules/sdc/jtosca.git/docs/architecture.rst + ../../../submodules/sdc/sdc-distribution-client.git/docs/architecture.rst + ../../../submodules/sdc/sdc-docker-base.git/docs/architecture.rst + ../../../submodules/sdc/sdc-titan-cassandra.git/docs/architecture.rst + ../../../submodules/sdc/sdc-tosca.git/docs/architecture.rst + ../../../submodules/sdc/sdc-workflow-designer.git/docs/architecture.rst + ../../../submodules/usecase-ui.git/docs/architecture.rst + ../../../submodules/vid/asdcclient.git/docs/architecture.rst + VID - Virtual Infrastructure Deployment <../../../submodules/vid.git/docs/intro/index> Platform Components ------------------- @@ -44,24 +44,24 @@ Platform Components :maxdepth: 1 :titlesonly: - ../../../submodules/appc/deployment.git/docs/index - ../../../submodules/appc.git/docs/index - ../../../submodules/dcaegen2.git/docs/index - ../../../submodules/holmes/engine-management.git/docs/index - ../../../submodules/holmes/rule-management.git/docs/index - ../../../submodules/policy/engine.git/docs/index - ../../../submodules/sdnc/adaptors.git/docs/index - ../../../submodules/sdnc/architecture.git/docs/index - ../../../submodules/sdnc/core.git/docs/index - ../../../submodules/sdnc/features.git/docs/index - ../../../submodules/sdnc/northbound.git/docs/index - ../../../submodules/sdnc/oam.git/docs/index - ../../../submodules/sdnc/parent.git/docs/index - ../../../submodules/sdnc/plugins.git/docs/index - ../../../submodules/so/libs.git/docs/index - ../../../submodules/so.git/docs/index - ../../../submodules/vfc/lcm.git/docs/index - ../../../submodules/vfc/nfvo/lcm.git/docs/index + ../../../submodules/appc/deployment.git/docs/architecture.rst + ../../../submodules/appc.git/docs/architecture.rst + ../../../submodules/dcaegen2.git/docs/architecture.rst + ../../../submodules/holmes/engine-management.git/docs/architecture.rst + ../../../submodules/holmes/rule-management.git/docs/architecture.rst + ../../../submodules/policy/engine.git/docs/architecture.rst + ../../../submodules/sdnc/adaptors.git/docs/architecture.rst + ../../../submodules/sdnc/architecture.git/docs/architecture.rst + ../../../submodules/sdnc/core.git/docs/architecture.rst + ../../../submodules/sdnc/features.git/docs/architecture.rst + ../../../submodules/sdnc/northbound.git/docs/architecture.rst + ../../../submodules/sdnc/oam.git/docs/architecture.rst + ../../../submodules/sdnc/parent.git/docs/architecture.rst + ../../../submodules/sdnc/plugins.git/docs/architecture.rst + ../../../submodules/so/libs.git/docs/architecture.rst + ../../../submodules/so.git/docs/architecture.rst + ../../../submodules/vfc/lcm.git/docs/architecture.rst + ../../../submodules/vfc/nfvo/lcm.git/docs/architecture.rst Platform Common Services ------------------------ @@ -70,23 +70,23 @@ Platform Common Services :maxdepth: 1 :titlesonly: - ../../../submodules/aaf/authz.git/docs/index - ../../../submodules/aai/aai-common.git/docs/index - ../../../submodules/aai/data-router.git/docs/index - ../../../submodules/aai/esr-gui.git/docs/index - ../../../submodules/aai/esr-server.git/docs/index - ../../../submodules/aai/resources.git/docs/index - ../../../submodules/aai/search-data-service.git/docs/index - ../../../submodules/aai/sparky-be.git/docs/index - ../../../submodules/aai/sparky-fe.git/docs/index - ../../../submodules/aai/traversal.git/docs/index - ../../../submodules/dmaap/messagerouter/messageservice.git/docs/index - ../../../submodules/msb/apigateway.git/docs/index - ../../../submodules/msb/discovery.git/docs/index - ../../../submodules/msb/java-sdk.git/docs/index - ../../../submodules/msb/swagger-sdk.git/docs/index - ../../../submodules/multicloud/framework.git/docs/index - ../../../submodules/oom.git/docs/index + ../../../submodules/aaf/authz.git/docs/architecture.rst + ../../../submodules/aai/aai-common.git/docs/architecture.rst + ../../../submodules/aai/data-router.git/docs/architecture.rst + ../../../submodules/aai/esr-gui.git/docs/architecture.rst + ../../../submodules/aai/esr-server.git/docs/architecture.rst + ../../../submodules/aai/resources.git/docs/architecture.rst + ../../../submodules/aai/search-data-service.git/docs/architecture.rst + ../../../submodules/aai/sparky-be.git/docs/architecture.rst + ../../../submodules/aai/sparky-fe.git/docs/architecture.rst + ../../../submodules/aai/traversal.git/docs/architecture.rst + ../../../submodules/dmaap/messagerouter/messageservice.git/docs/architecture.rst + ../../../submodules/msb/apigateway.git/docs/architecture.rst + ../../../submodules/msb/discovery.git/docs/architecture.rst + ../../../submodules/msb/java-sdk.git/docs/architecture.rst + ../../../submodules/msb/swagger-sdk.git/docs/architecture.rst + ../../../submodules/multicloud/framework.git/docs/architecture.rst + ../../../submodules/oom.git/docs/architecture.rst SDKs ---- @@ -95,21 +95,21 @@ SDKs :maxdepth: 1 :titlesonly: - ../../../submodules/ccsdk/dashboard.git/docs/index - ../../../submodules/ccsdk/distribution.git/docs/index - ../../../submodules/ccsdk/parent.git/docs/index - ../../../submodules/ccsdk/platform/blueprints.git/docs/index - ../../../submodules/ccsdk/platform/nbapi.git/docs/index - ../../../submodules/ccsdk/platform/plugins.git/docs/index - ../../../submodules/ccsdk/sli/adaptors.git/docs/index - ../../../submodules/ccsdk/sli/core.git/docs/index - ../../../submodules/ccsdk/sli/northbound.git/docs/index - ../../../submodules/ccsdk/sli/plugins.git/docs/index - ../../../submodules/ccsdk/storage/esaas.git/docs/index - ../../../submodules/ccsdk/storage/pgaas.git/docs/index - ../../../submodules/ccsdk/utils.git/docs/index - ../../../submodules/portal.git/docs/index - ../../../submodules/vnfsdk/model.git/docs/index + ../../../submodules/ccsdk/dashboard.git/docs/architecture.rst + ../../../submodules/ccsdk/distribution.git/docs/architecture.rst + ../../../submodules/ccsdk/parent.git/docs/architecture.rst + ../../../submodules/ccsdk/platform/blueprints.git/docs/architecture.rst + ../../../submodules/ccsdk/platform/nbapi.git/docs/architecture.rst + ../../../submodules/ccsdk/platform/plugins.git/docs/architecture.rst + ../../../submodules/ccsdk/sli/adaptors.git/docs/architecture.rst + ../../../submodules/ccsdk/sli/core.git/docs/architecture.rst + ../../../submodules/ccsdk/sli/northbound.git/docs/architecture.rst + ../../../submodules/ccsdk/sli/plugins.git/docs/architecture.rst + ../../../submodules/ccsdk/storage/esaas.git/docs/architecture.rst + ../../../submodules/ccsdk/storage/pgaas.git/docs/architecture.rst + ../../../submodules/ccsdk/utils.git/docs/architecture.rst + ../../../submodules/portal.git/docs/architecture.rst + ../../../submodules/vnfsdk/model.git/docs/architecture.rst Other ----- @@ -118,7 +118,7 @@ Other :maxdepth: 1 :titlesonly: - ../../../submodules/integration.git/docs/index - ../../../submodules/optf/has.git/docs/index - ../../../submodules/vnfrqts/guidelines.git/docs/index - ../../../submodules/vnfrqts/requirements.git/docs/index + ../../../submodules/integration.git/docs/architecture.rst + ../../../submodules/optf/has.git/docs/architecture.rst + ../../../submodules/vnfrqts/guidelines.git/docs/architecture.rst + ../../../submodules/vnfrqts/requirements.git/docs/architecture.rst diff --git a/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst b/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst index 9586b4b5a..8fd9a730b 100644 --- a/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst +++ b/docs/guides/onap-developer/how-to-use-docs/documentation-guide.rst @@ -147,7 +147,11 @@ files: .. code-block:: bash .. This work is licensed under a Creative Commons Attribution 4.0 International License. - .. (c) <optionally add copyrights company name> + .. http://creativecommons.org/licenses/by/4.0 + .. Copyright YEAR ONAP or COMPANY or INDIVIDUAL These lines will not be rendered in the html and pdf files. +When there are subsequent, significant contributions to a source file from a different contributor, +a new copyright line may be appended after the last existing copyright line. + diff --git a/docs/release/index.rst b/docs/release/index.rst index 9ff201ddb..5a7671a38 100644 --- a/docs/release/index.rst +++ b/docs/release/index.rst @@ -26,6 +26,8 @@ the Amsterdam Release and provide detailed release notes at the links below. .. include:: releaserepos.rst +Projects Providing Documentation +-------------------------------- .. include:: repolist.rst - + diff --git a/docs/release/repolist.rst b/docs/release/repolist.rst index db831b5e0..158e12444 100644 --- a/docs/release/repolist.rst +++ b/docs/release/repolist.rst @@ -1,8 +1,5 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. -Projects Providing Documentation --------------------------------- - Documentation organized by the project delivering them. .. note:: @@ -48,6 +45,7 @@ Documentation organized by the project delivering them. holmes/engine-management <../submodules/holmes/engine-management.git/docs/index> holmes/rule-management <../submodules/holmes/rule-management.git/docs/index> integration <../submodules/integration.git/docs/index> + logging-analytics <../submodules/logging-analytics.git/docs/index> modeling/modelspec <../submodules/modeling/modelspec.git/docs/index> msb/apigateway <../submodules/msb/apigateway.git/docs/index> msb/discovery <../submodules/msb/discovery.git/docs/index> @@ -55,7 +53,7 @@ Documentation organized by the project delivering them. msb/swagger-sdk <../submodules/msb/swagger-sdk.git/docs/index> multicloud/framework <../submodules/multicloud/framework.git/docs/index> oom <../submodules/oom.git/docs/index> - Optimization Framework: Homing and Allocation <../submodules/optf/has.git/docs/index> + optf/has <../submodules/optf/has.git/docs/index> policy/engine <../submodules/policy/engine.git/docs/index> portal <../submodules/portal.git/docs/index> sdc/jtosca <../submodules/sdc/jtosca.git/docs/index> @@ -73,8 +71,9 @@ Documentation organized by the project delivering them. sdnc/oam <../submodules/sdnc/oam.git/docs/index> sdnc/parent <../submodules/sdnc/parent.git/docs/index> sdnc/plugins <../submodules/sdnc/plugins.git/docs/index> - so <../submodules/so.git/docs/index> so/libs <../submodules/so/libs.git/docs/index> + so <../submodules/so.git/docs/index> + usecase-ui <../submodules/usecase-ui.git/docs/index> vfc/nfvo/lcm <../submodules/vfc/lcm.git/docs/index> vfc/nfvo/lcm <../submodules/vfc/nfvo/lcm.git/docs/index> vid/asdcclient <../submodules/vid/asdcclient.git/docs/index> @@ -82,5 +81,3 @@ Documentation organized by the project delivering them. vnfrqts/guidelines <../submodules/vnfrqts/guidelines.git/docs/index> vnfrqts/requirements <../submodules/vnfrqts/requirements.git/docs/index> vnfsdk/model <../submodules/vnfsdk/model.git/docs/index> - usecase-ui <../submodules/usecase-ui.git/docs/index> - logging-analytics <../submodules/logging-analytics.git/docs/index> diff --git a/docs/submodules/so/libs.git b/docs/submodules/so/libs.git -Subproject 4ee9b223bc85bfaae4e1911b439d94d4cf424cd +Subproject f47593695b68356803d45475b85a0e12388426c diff --git a/docs/templates/collections/platform-component.rst b/docs/templates/collections/platform-component.rst index 7e7849a04..98119aca5 100644 --- a/docs/templates/collections/platform-component.rst +++ b/docs/templates/collections/platform-component.rst @@ -2,8 +2,8 @@ .. http://creativecommons.org/licenses/by/4.0 -Platform Component Name -======================= +Platform Component +================== .. Add or remove sections below as appropriate for the platform component. diff --git a/docs/templates/collections/sdk.rst b/docs/templates/collections/sdk.rst index f86c33f5c..7fb01eb6b 100644 --- a/docs/templates/collections/sdk.rst +++ b/docs/templates/collections/sdk.rst @@ -1,8 +1,8 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -SDK Name -======== +SDK +=== .. Add or remove sections below as appropriate for the SDK |