1bc85ca9660b41c623f3fef180f5705f4364feb9
[doc.git] / docs / index.rst
1 .. This work is licensed under a
2    Creative Commons Attribution 4.0 International License.
3
4 .. _master_index:
5
6
7
8 .. please disable below in the release version
9
10 .. warning:: **WORK IN PROGRESS**
11
12    .. figure:: _static/exclamation-triangle.svg
13        :align: left
14        :scale: 760%
15        :figwidth: 120px
16        
17    This is a development version of ONAP documentation. It continually
18    develops as the contributing projects develop. Even if you read a specific
19    release name here, the content may cover a future ONAP release.
20    
21    **The official release documentation for ONAP 'Kohn' can be found**
22    `[here] <https://docs.onap.org/en/kohn/>`__
23
24 |
25
26 .. please disable above in the release version
27
28 Open Network Automation Platform
29 ================================
30
31 Open Network Automation Platform (ONAP) is an open source project hosted by
32 the Linux Foundation.
33
34 ONAP provides a comprehensive platform for real-time, policy-driven service
35 orchestration and automation. ONAP enables service providers and developers
36 to rapidly automate the instantiation and configuration of physical and
37 virtual network functions and to support complete life cycle management
38 activities. By unifying the resources of open source members, ONAP enables
39 the acceleration of the development of a vibrant ecosystem around a globally
40 shared architecture and the implementation of network automation faster than
41 any product could on its own.
42
43 -------------------------------------------------------------------------------
44
45 :ref:`'Kohn' Release Notes <onap-release-notes>`
46 ------------------------------------------------
47
48 .. figure:: _static/file.svg
49     :align: left
50     :scale: 300%
51     :figwidth: 50px
52     
53 General information about the new ONAP release and recent changes, feature
54 enhancements, or bug fixes.
55
56 |
57
58 :ref:`Component Release Notes <component-release-notes>`
59 --------------------------------------------------------
60
61 .. figure:: _static/files.svg
62     :align: left
63     :scale: 300%
64     :figwidth: 50px
65
66 Project specific information about recent changes, features, enhancements, or
67 bug fixes.
68
69 |
70
71 :ref:`Release History <release-history>`
72 ----------------------------------------
73
74 .. figure:: _static/clock-history.svg
75     :align: left
76     :scale: 300%
77     :figwidth: 50px
78
79 Names and release dates of previous ONAP versions.
80
81 |
82
83 -------------------------------------------------------------------------------
84
85 :ref:`Overview <overview>`
86 --------------------------
87
88 .. figure:: _static/eye.svg
89     :align: left
90     :scale: 300%
91     :figwidth: 50px
92
93 A high-level guidance on the mission and main functionalities of ONAP. Basic
94 guidelines on license details, limitations and security references support
95 understanding the solution.
96
97 |
98
99 :ref:`Architecture <ONAP-architecture>`
100 ---------------------------------------
101
102 .. figure:: _static/columns-gap.svg
103     :align: left
104     :scale: 300%
105     :figwidth: 50px
106
107 A general description of functional ONAP components and how they interact.
108 Covers the design-time and runtime framework, ONAP microservices and common
109 services.
110
111 |
112
113 :ref:`Components and Functionalities <doc_onap-developer_guide_projects>`
114 -------------------------------------------------------------------------
115
116 .. figure:: _static/diagram-3.svg
117     :align: left
118     :scale: 300%
119     :figwidth: 50px
120
121 A individual description of every ONAP component and its features.
122
123 |
124
125 -------------------------------------------------------------------------------
126
127 :ref:`Operations and Administration Guides <operation_guides>`
128 --------------------------------------------------------------
129
130 .. figure:: _static/person-gear.svg
131     :align: left
132     :scale: 300%
133     :figwidth: 50px
134
135 The installation of ONAP, its management, monitoring and other operational
136 tasks like integration or user management are covered here.
137
138 |
139
140 :ref:`Developer Guides <ONAP_developer_guides>`
141 -----------------------------------------------
142
143 .. figure:: _static/code-slash.svg
144     :align: left
145     :scale: 300%
146     :figwidth: 50px
147
148 Developers contributing to the ONAP development can find information here.
149
150 |
151
152 :ref:`Documentation Guides <ONAP_documentation_guides>`
153 -------------------------------------------------------
154
155 .. figure:: _static/filetype-rst.svg
156     :align: left
157     :scale: 300%
158     :figwidth: 50px
159
160 A guide to set up a documentation development environment, documentation style
161 guides, tips and templates are provided here.
162
163 |
164
165 -------------------------------------------------------------------------------
166
167 :ref:`Vulnerabilities and Advisories <onap-security-index>`
168 -----------------------------------------------------------
169
170 .. figure:: _static/shield.svg
171     :align: left
172     :scale: 300%
173     :figwidth: 50px
174
175 Describes the current state of ONAP Security. Learn about discovered and fixed
176 vulnerabilities and how to report them.
177
178
179 .. toctree::
180    :maxdepth: 1
181    :hidden:
182
183    Home <self>
184
185 .. toctree::
186    :maxdepth: 1
187    :hidden:  
188    :caption: RELEASE
189
190    release/index
191    release/component-release-notes
192    release/history
193
194 .. toctree::
195    :maxdepth: 1
196    :hidden:  
197    :caption: USE CASES
198
199    usecases/index
200
201 .. toctree::
202    :maxdepth: 1
203    :hidden:  
204    :caption: PLATFORM
205
206    platform/overview/index
207    platform/architecture/index
208    platform/components/index
209
210 .. toctree::
211    :maxdepth: 1
212    :hidden:  
213    :caption: GUIDES
214
215    guides/onap-operator/index
216    guides/onap-developer/index
217    guides/onap-documentation/index
218
219 .. toctree::
220    :maxdepth: 1
221    :hidden:
222    :caption: SECURITY
223
224    security/index