IRONSIDE-1156 -- merge release/connector/1.3.0 to develop (#202)

* COMMUNITY-78: update submodule

* COMMUNITY-86 | Backport COMMUNITY-79 and COMMUNITY-80 to release/connector/1.3.0 (#191)

* COMMUNITY-86: backport COMMUNITY-79 back to release/connector/1.3.0

* COMMUNITY-86: backport COMMUNITY-80 back to release/connector/1.3.0

* COMMUNITY-86: update submodule

* CON-305: Update Platform Notes (#192)

* Apply suggestions from code review

* CON-305: Update documentation (#194)

* Fix license pdf (#197)

* Use the current lts instead of the latest one (#196)

* Use current lts instead of the latest one fixes #195

* 20 is equal to lts-iron

* Update submodule commit

* Update submodule commit

* CON-311: Add warning to documentation (#199)

* CON-311: Add warning to documentation

* CON-311: Apply feedback

* CON-311: Add GH Issue link

* Update docs/release_notes.rst

Co-authored-by: lloadholt <117761400+lloadholt@users.noreply.github.com>

---------

Co-authored-by: lloadholt <117761400+lloadholt@users.noreply.github.com>

* DOC-489: Correct headings in Previous Releases section (#200)

* DOC-489: Correct headings in Previous Releases section

* DOC-489: More corrections

* DOC-489: Increase index depth

* DOC-489: Heading corrections

* Update release_notes.rst (#201)

* IRONSIDE-1156 -- PR comment, must include lts in config file ...

* Correct release_notes.rst

Moved 1.0.0 text to heading "Version 1.0.0"

* Update release_notes.rst

---------

Co-authored-by: ManuelJNunez <manueljesusnunezruiz@gmail.com>
Co-authored-by: Alejandro <alejnp@rti.com>
Co-authored-by: Alex Campos <alejandro@rti.com>
Co-authored-by: lloadholt <117761400+lloadholt@users.noreply.github.com>

Author: 5 people

LICENSE.pdf

@@ -1,14 +1,20 @@
 Release Notes
-=============
+*************
 
 Supported Platforms
--------------------
+===================
 
 *Connector* has been validated to run with the following Node.js versions:
-  * v17
   * v18
+  * v19
   * v20
 
+.. warning::
+  Due to an upstream change in Node.js, **some versions will fail when building
+  Connector dependencies**. This issue affects, at the very least,
+  Node.js versions 18.20, 20.12 and 21.6.
+  For more information, see `Github Issue #198 <https://github.com/rticommunity/rticonnextdds-connector-js/issues/198>`_.
+
 Other versions may also work, but have not been validated internally.
 If you run into an issue, make sure that the issue can be reproduced
 in any of the versions listed above.
@@ -34,14 +40,17 @@ repository <https://github.com/rticommunity/rticonnextdds-connector>`__.
 
 
 Version 1.3.0
------------------
+=============
+
+What's New in 1.3.0
+-------------------
 
 *RTI Connector* 1.3.0 is built on 
 `RTI Connext DDS 7.3.0 <https://community.rti.com/documentation/rti-connext-dds-730>`__.
 
 
 Failed to create a Connector in certain Node versions (18.8 or greater)
-"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 .. CON-299
 
 Due to an incompatibility in some *Connector* dependencies, it was not 
@@ -60,10 +69,13 @@ This issue is known to have affected Node.js versions 18.8 and 20; other
 versions may also have been affected.
 
 Previous Releases
------------------
+=================
 
 Version 1.2.2
-^^^^^^^^^^^^^
+-------------
+
+What's New in 1.2.2
+^^^^^^^^^^^^^^^^^^^
 
 *RTI Connector* 1.2.2 is built on 
 `RTI Connext DDS 6.1.2 <https://community.rti.com/documentation/rti-connext-dds-612>`__.
@@ -78,29 +90,32 @@ libraries are now built using Visual Studio 2015. The redistributable that is
 shipped has been updated accordingly.
 
 Version 1.2.1
-^^^^^^^^^^^^^
+-------------
+
+What's New in 1.2.1
+^^^^^^^^^^^^^^^^^^^
 
 *Connector* 1.2.1 updates some third party dependencies that were found to contain
 vulnerabilities. *Connector* was not affected by these vulnerabilities.
 
 Version 1.2.0
-^^^^^^^^^^^^^
+-------------
 
 What's New in 1.2.0
-"""""""""""""""""""
+^^^^^^^^^^^^^^^^^^^
 
 *RTI Connector* 1.2.0 is built on 
 `RTI Connext DDS 6.1.1 <https://community.rti.com/documentation/rti-connext-dds-611>`__.
 
 New Platforms
-+++++++++++++
+"""""""""""""
 
 *Connector* has been validated on macOS 11 (Big Sur) systems on x64 and Arm v8 
 CPUs (via x64 libraries).
 
 
 New API makes it easier to query what version of Connector is being used
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .. CON-92 
 
 A new API, :meth:`Connector.getVersion`, has been added that provides the
@@ -109,10 +124,10 @@ libraries being used.
 
 
 What's Fixed in 1.2.0
-"""""""""""""""""""""
+^^^^^^^^^^^^^^^^^^^^^
 
 Error logged when accessing string longer than 128 bytes
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 Previously, on an input, when accessing a string longer than 128 bytes, the
 following error was printed:
@@ -128,7 +143,7 @@ the string. The message is no longer printed.
 
 
 Support added for handling large 64-bit integers
-++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""
 
 Support has been improved for both getting and setting large (greater than 2^53)
 64-bit values. See :ref:`section-access-64-bit-integers-js` for more information.
@@ -137,7 +152,7 @@ Support has been improved for both getting and setting large (greater than 2^53)
 
 
 Promise returned by Output.wait did not resolve/reject
-++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 The Promise being returned by the Output.wait method (used to wait for
 acknowledgements on an output) was not being resolved or rejected. This
@@ -148,9 +163,8 @@ supplied timeout has elapsed.
 
 [RTI Issue ID CON-227]
 
-
 Version 1.1.1
-^^^^^^^^^^^^^
+-------------
 
 *Connector* 1.1.1 is built on *RTI Connext DDS* 6.1.0.3, which fixes several
 bugs in the Core Libraries. If you want more details on the bugs fixed in 6.1.0.3,
@@ -159,23 +173,23 @@ contact support@rti.com. These bugs are also fixed in
 upon which *RTI Connector* 1.2.0 is built.
 
 Version 1.1.0
-^^^^^^^^^^^^^
+-------------
 
 What's New in 1.1.0
-""""""""""""""""""""
+^^^^^^^^^^^^^^^^^^^
 
 *RTI Connector* 1.1.0 is built on `RTI Connext DDS 6.1.0 <https://community.rti.com/documentation/rti-connext-dds-610>`__.
 
 Support added for ARMv8 architectures
-+++++++++++++++++++++++++++++++++++++
+"""""""""""""""""""""""""""""""""""""
 .. CON-174 
 
 Connector for JavaScript now runs on ARMv8 architectures. Native libraries
 built for ARMv8 Ubuntu 16.04 are now shipped alongside Connector. These libraries
 have been tested on ARMv8 Ubuntu 16.04 and ARMv8 Ubuntu 18.04.
 
 Support added for Node.js version 12
-++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""
 .. CON-173 
 
 Previously, Node.js version 12 was not supported in *Connector* for JavaScript.
@@ -187,7 +201,7 @@ Connector for JavaScript.
 
 
 Sample state, instance state and view state can now be obtained in Connector
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .. CON-177 
 
 The :class:`SampleInfo` class in *Connector* has been extended to provide access to the
@@ -199,7 +213,7 @@ new feature.
 
 
 Support for accessing the key values of disposed instances
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .. CON-188 
 
 Support for disposing instances was added in *Connector* 1.0.0.
@@ -214,15 +228,15 @@ See :ref:`Accessing key values of disposed samples` for more
 information on this new feature.
 
 Connector for Javascript dependencies now locked to specific versions
-+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .. CON-220 
 
 ``package-lock.json`` has been committed, fixing the versions of *Connector for 
 Javascript's* dependencies.
 
 
 Support for Security, Monitoring and other Connext DDS add-on libraries
-+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 .. CON-221
 
@@ -231,10 +245,10 @@ that Connext DDS features such as Monitoring and Security Plugins are now suppor
 Refer to :ref:`Loading Connext DDS Add-On Libraries` for more information.
 
 What's Fixed in 1.1.0
-""""""""""""""""""""""
+^^^^^^^^^^^^^^^^^^^^^
 
 Creating two instances of Connector resulted in a license error
-+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 Under some circumstances, it was not possible to create two *Connector* objects.
 The creation of the second *Connector* object failed due to a license error.
@@ -245,7 +259,7 @@ This issue has been fixed.
 
 
 Some larger integer values may have been corrupted by Connector's internal JSON parser
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 The internal JSON parser used in *Connector* failed to identify integer numbers
 from double-precision floating-point numbers for certain values.
@@ -257,7 +271,7 @@ become corrupted. This problem has been resolved.
 
 
 Support for loading multiple configuration files
-++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""
 
 A *Connector* object now supports loading multiple files. This allows separating
 the definition of types, QoS profiles, and *DomainParticipants* into different
@@ -271,7 +285,7 @@ files:
 
 
 Creating a Connector instance with a participant_qos tag in the XML may have resulted in a license error
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 
 In some cases, if the XML configuration file of *Connector* contained a
 `<participant_qos>` tag within the definition of the *DomainParticipant*,
@@ -282,7 +296,7 @@ This problem has been resolved.
 
 
 Websocket example may have failed to run
-++++++++++++++++++++++++++++++++++++++++
+""""""""""""""""""""""""""""""""""""""""
 
 The websocket example (available only in *Connector for Javascript*) may have 
 failed to run due to one of its dependencies, socket.io, removing a public API. 
@@ -292,7 +306,7 @@ This problem has been resolved.
 
 
 Version 1.0.0
-^^^^^^^^^^^^^
+-------------
 
 1.0.0 is the first official release of *RTI Connector for JavaScript* as well as
 `RTI Connector for Python <https://community.rti.com/static/documentation/connector/1.0.0/api/python/index.html>`__.
@@ -305,7 +319,10 @@ APIs have been preserved for backward compatibility as much as possible.
 
 
 Vulnerability Assessments
--------------------------
+=========================
 Internally, *Connector* relies on Lua. RTI has assessed the current version of 
 Lua used by *Connector*, version 5.2, and found that *Connector* is not currently 
 affected by any of the publicly disclosed vulnerabilities in Lua 5.2.
+
+
+