Update release notes for Phosphorus-SR1
[docs.git] / docs / release-notes / index.rst
index 5843d5b829c380d918beb769ca96f9f2c66fccde..e0ec55d1b1a3f7d787bdb043a675b08abda6453b 100644 (file)
 Release Notes
 #############
 
-Target Environment
-==================
-
-For Execution
--------------
-
-The OpenDaylight Karaf container, OSGi bundles, and Java class files
-are portable and should run on any Java 7- or Java 8-compliant JVM to
-run. Certain projects and certain features of some projects may have
-additional requirements. Those are noted in the project-specific
-release notes.
-
-Projects and features which have known additional requirements are:
-
-* TCP-MD5 requires 64-bit Linux
-* TSDR has extended requirements for external databases
-* Persistence has extended requirements for external databases
-* SFC requires addition features for certain configurations
-* SXP depends on TCP-MD5 on thus requires 64-bit Linux
-* SNBI has requirements for Linux and Docker
-* OpFlex requires Linux
-* DLUX requires a modern web browser to view the UI
-* AAA when using federation has additional requirements for external tools
-* VTN has components which require Linux
-
-For Development
----------------
-
-OpenDaylight is written primarily in Java project and primarily uses
-Maven as a build tool Consequently the two main requirements to develop
-projects within OpenDaylight are:
-
-* A Java 8-compliant JDK
-* Maven 3.1.1 or later
-
-Applications and tools built on top of OpenDaylight using it's REST
-APIs should have no special requirements beyond whatever is needed to
-run the application or tool and make the REST calls.
-
-In some places, OpenDaylight makes use of the Xtend language. While
-Maven will download the appropriate tools to build this, additional
-plugins may be required for IDE support.
-
-The projects with additional requirements for execution typically have
-similar or more extensive additional requirements for development. See
-the project-specific release notes for details.
-
-Known Issues and Limitations
-============================
-
-Other than as noted in project-specific release notes, we know of the
-following limitations:
-
-* Migration from prior OpenDaylight releases to Nitrogen has not been
-  extensively tested. The per-project release notes include migration and
-  compatibility information when it is known.
-* There are scales beyond which the controller has been unreliable when
-  collecting flow statistics from OpenFlow switches. In tests, these
-  issues became apparent when managing thousands of OpenFlow
-  switches, however this may vary depending on deployment and use cases.
-
-Project-specific Release Notes
-==============================
+Execution
+---------
+
+OpenDaylight includes `Karaf <https://karaf.apache.org>`_ containers, `OSGi <https://www.osgi.org>`_
+(Open Service Gateway Initiative) bundles, and Java class files, which are portable and can run on
+any Java 11-compliant JVM (Java virtual machine). Any add-on project or feature of a
+specific project may have additional requirements.
+
+Development
+-----------
+
+OpenDaylight is written in Java and utilizes Maven as a build tool. Therefore,
+the only requirements needed to develop projects within OpenDaylight include:
+
+* `Java JDK 11 <https://www.oracle.com/java/technologies/javase/products-doc-jdk11certconfig.html>`_
+* `Apache Maven <https://maven.apache.org>`_ 3.5.2 or later
+
+If an application or tool is built on top of OpenDaylight’s REST APIs, it does not
+have any special requirement beyond what is necessary to run the application or tool
+to make REST calls.
+
+In some instances, OpenDaylight uses the `Xtend <https://www.eclipse.org/xtend/>`_ language.
+Even though Maven downloads all appropriate tools to build applications; additional plugins
+may be required to support IDE.
+
+Projects with additional requirements for execution typically have similar or
+additional requirements for development. See the platforms release notes for details.
+
+Platform Release Notes
+======================
 
 .. toctree::
+   :glob:
    :maxdepth: 1
 
-   projects/aaa
-   projects/alto
-   projects/bgp-ls-pcep
-   projects/bier
-   projects/cardinal
-   projects/controller
-   projects/daexim
-   projects/didm
-   projects/distribution
-   projects/dlux
-   projects/dluxapps
-   projects/eman
-   projects/faas
-   projects/gbp
-   projects/genius
-   projects/infrautils
-   projects/iotdm
-   projects/l2switch
-   projects/lispflowmapping
-   projects/mdsal
-   projects/nemo
-   projects/netconf
-   projects/netide
-   projects/netvirt
-   projects/neutron-northbound
-   projects/nic
-   projects/ocpplugin
-   projects/odlparent
-   projects/odl-sdni.rst
-   projects/of-config
-   projects/openflowjava
-   projects/openflowplugin
-   projects/opflex
-   projects/ovsdb
-   projects/packetcable
-   projects/sfc
-   projects/snmp
-   projects/snmp4sdn
-   projects/sxp
-   projects/topology-processing-framework
-   projects/tsdr
-   projects/ttp
-   projects/unimgr
-   projects/usc
-   projects/vbd
-   projects/vtn
-   projects/yangtools
+   upgrade-process
 
+Project Release Notes
+=====================
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   projects/*
 
 Service Release Notes
 =====================
 
 .. toctree::
    :glob:
-   :maxdepth: 2
+   :maxdepth: 1
 
    release-notes-*
-