Polishes remaining documentation pages.

Author: hidmic

source/About.rst

@@ -2,6 +2,6 @@
 About this documentation
 ========================
 
-This documentation lives in http://github.com/ros2/ros2_documentation. Purely written in `ReST markup format <http://docutils.sourceforge.net/rst.html>`_, it is processed using Sphinx during ROSIndex builds. `Intersphinx support <Contributing/Inter-Sphinx-Support>` is readily available for cross-linking package specific entities.
+This documentation lives in http://github.com/ros2/ros2_documentation. Purely written in `ReST markup format <http://docutils.sourceforge.net/rst.html>`__, it is processed using Sphinx during ROSIndex builds. `Intersphinx support <Contributing/Inter-Sphinx-Support>` is readily available for cross-linking package specific entities.
 
 Updates submission is currently handled through pull requests.

source/Contact.rst

@@ -7,7 +7,7 @@ If you try out ROS 2 and have feedback or questions, please get in touch with us
 General/design discussion
 -------------------------
 
-Discussions about ROS 2 development and plans are happening on the `“Next Generation ROS” Discourse category <http://discourse.ros.org/c/ng-ros>`__ (previously on the `sig-ng-ros (Special Interest Group on Next-Generation ROS) mailing list <https://groups.google.com/forum/?fromgroups#!forum/ros-sig-ng-ros>`__\ ).
+Discussions about ROS 2 development and plans are happening on the `“Next Generation ROS” Discourse category <http://discourse.ros.org/c/ng-ros>`__ (previously on the `sig-ng-ros (Special Interest Group on Next-Generation ROS) mailing list <https://groups.google.com/forum/?fromgroups#!forum/ros-sig-ng-ros>`__).
 Join us there and participate in the conversation.
 
 If you'd like to contact us privately (e.g., if your question contains information sensitive to your organization or project), you can email us directly at ``[email protected]``.

source/Features.rst

@@ -1,7 +1,6 @@
 
-ROS 2 Features Status
-=====================
-
+Features Status
+===============
 
 The features listed below are available in the current ROS 2 release.
 Unless otherwise specified, the features are available for all supported platforms (Ubuntu 18.04, OS X 10.12.x, Windows 10), DDS implementations (eProsima Fast RTPS, RTI Connext and ADLINK Opensplice) and programming language client libraries (C++ and Python).
@@ -65,7 +64,7 @@ For planned future development, see the `Roadmap <Roadmap>`.
      - `Demo <https://github.com/ros2/turtlebot2_demo>`__
      -
    * - Preliminary support for real-time code
-     - `Demo <Tutorials/Real-Time-Programming>`\ , `demo <Tutorials/Allocator-Template-Tutorial>`
+     - `Demo <Tutorials/Real-Time-Programming>`, `demo <Tutorials/Allocator-Template-Tutorial>`
      - Linux only. Not available for Fast RTPS.
    * - Preliminary support for "bare-metal" microcontrollers
      - `Wiki <https://github.com/ros2/freertps/wiki>`__

source/Related-Projects.rst

@@ -1,9 +1,8 @@
 
-ROS 2 Related Projects
-======================
+Related Projects
+================
 
 .. toctree::
-   :titlesonly:
    :maxdepth: 1
 
    Related-Projects/Intel-ROS2-Projects

source/Related-Projects/Intel-ROS2-Projects.rst

@@ -9,16 +9,16 @@ Key Projects
 
 We are working on below ROS2 projects and publish source code through https://github.com/intel/ or ROS2 github repo gradually.
 
-*  `ROS2 OpenVINO <https://github.com/intel/ros2_openvino_toolkit>`_: ROS2 package for Intel® Visual Inference and Neural Network Optimization Toolkit to develop multiplatform computer vision solutions.
-* `ROS2 RealSense Camera <https://github.com/intel/ros2_intel_realsense>`_: ROS2 package for Intel® RealSense™ D400 serial cameras
-* `ROS2 Movidius NCS <https://github.com/intel/ros2_intel_movidius_ncs>`_: ROS2 package for object detection with Intel® Movidius™ Neural Computing Stick (NCS).
-* `ROS2 Object Messages <https://github.com/intel/ros2_object_msgs>`_: ROS2 messages for object.
-* `ROS2 Object Analytics <https://github.com/intel/ros2_object_analytics>`_: ROS2 package for object detection, tracking and 2D/3D localization.
-* `ROS2 Message Filters <https://github.com/ros2/message_filters>`_: ROS2 package for message synchronization with time stamp.
-* `ROS2 CV Bridge <https://github.com/ros-perception/vision_opencv/tree/ros2/cv_bridge>`_: ROS2 package to bridge with openCV.
-* `ROS2 Object Map <https://github.com/intel/ros2_object_map>`_: ROS2 package to mark tag of objects on map when SLAM based on information provided by ROS2 object analytics.
-* `ROS2 Moving Object <https://github.com/intel/ros2_moving_object>`_: ROS2 package to provide object motion information (like object velocity on x, y, z axis) based on information provided by ROS2 object analytics.
-* `ROS2 Grasp Library <https://github.com/intel/ros2_grasp_library>`_: Coming soon. ROS2 package for grasp position analysis, and compatible with `MoveIt <https://github.com/ros-planning/moveit.git>`_ grasp interfaces.
+*  `ROS2 OpenVINO <https://github.com/intel/ros2_openvino_toolkit>`__: ROS2 package for Intel® Visual Inference and Neural Network Optimization Toolkit to develop multiplatform computer vision solutions.
+* `ROS2 RealSense Camera <https://github.com/intel/ros2_intel_realsense>`__: ROS2 package for Intel® RealSense™ D400 serial cameras
+* `ROS2 Movidius NCS <https://github.com/intel/ros2_intel_movidius_ncs>`__: ROS2 package for object detection with Intel® Movidius™ Neural Computing Stick (NCS).
+* `ROS2 Object Messages <https://github.com/intel/ros2_object_msgs>`__: ROS2 messages for object.
+* `ROS2 Object Analytics <https://github.com/intel/ros2_object_analytics>`__: ROS2 package for object detection, tracking and 2D/3D localization.
+* `ROS2 Message Filters <https://github.com/ros2/message_filters>`__: ROS2 package for message synchronization with time stamp.
+* `ROS2 CV Bridge <https://github.com/ros-perception/vision_opencv/tree/ros2/cv_bridge>`__: ROS2 package to bridge with openCV.
+* `ROS2 Object Map <https://github.com/intel/ros2_object_map>`__: ROS2 package to mark tag of objects on map when SLAM based on information provided by ROS2 object analytics.
+* `ROS2 Moving Object <https://github.com/intel/ros2_moving_object>`__: ROS2 package to provide object motion information (like object velocity on x, y, z axis) based on information provided by ROS2 object analytics.
+* `ROS2 Grasp Library <https://github.com/intel/ros2_grasp_library>`__: Coming soon. ROS2 package for grasp position analysis, and compatible with `MoveIt <https://github.com/ros-planning/moveit.git>`__ grasp interfaces.
 
 Reference
 ---------

source/Roadmap.rst

@@ -1,6 +1,10 @@
 
-ROS 2 Roadmap
-=============
+Roadmap
+=======
+
+.. contents:: Table of Contents
+   :depth: 2
+   :local:
 
 For more information on the design of ROS 2 please see `design.ros2.org <http://design.ros2.org>`__.
 The core code for ROS 2 is on the `ros2 github organization <https://github.com/ros2>`__.
@@ -15,7 +19,7 @@ This is a list of the features targeted for development in the future.
 *Subject to change.*
 
 Next release - D-turtle (June 2019)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The `D-turtle meta ticket <https://github.com/ros2/ros2/issues/607>`__ on GitHub will in the near future enumerate the ongoing high level tasks as well as references specific tickets with more details.
 
@@ -25,7 +29,6 @@ Future (in no specific order)
 Design / Concept
 ~~~~~~~~~~~~~~~~
 
-
 * Support for non-ASCII strings in messages / services
 * Progress on migration plan
 * Reconsider 1-to-1 mapping of ROS nodes to DDS participants
@@ -34,7 +37,6 @@ Design / Concept
 Infrastructure and tools
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-
 * Building
 
   * Support to generate "fat" packages / archives
@@ -119,7 +121,6 @@ The trailing stars indicate the rough effort: 1 star for small, 2 stars for medi
 Port of existing ROS 1 functionality
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-
 * Perception metapackage
 
   * Image pipeline
@@ -130,7 +131,7 @@ Port of existing ROS 1 functionality
   * Needs Actions
   * Moveit Maintainers are tracking: https://discourse.ros.org/t/moveit-maintainer-meeting-recap-july-25th-2018/5504
 
-* Rqt
+* RQt
 
   * convert more plugins [\* each when dependencies are available]
 
@@ -139,7 +140,6 @@ Port of existing ROS 1 functionality
 Reducing Technical Debt
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-
 * Extend testing and resolve bugs in the current code base
 
   * Waitset inconsistency

source/Troubleshooting.rst

@@ -1,9 +1,9 @@
 
 Troubleshooting
----------------
+===============
 
 Enable Multicast
-^^^^^^^^^^^^^^^^
+----------------
 
 In order to communicate successfully via DDS, the used network interface has to be multicast enabled.
 We've seen in past experiences that this might not necessarily be enabled by default (on Ubuntu or OSX) when using the loopback adapter.
@@ -23,9 +23,9 @@ In Terminal 2:
    ros2 multicast send
 
 Import failing even with library present on the system
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------------------------
 
 Sometimes ``rclpy`` fails to be imported because of some missing DLLs on your system.
-If so make sure to install all the dependencies listed in the "Installing prerequisites" sections of the installation instructions (`Windows <windows-install-binary-installing-prerequisites>`\ , `MacOS <osx-install-binary-installling-prerequisites>`\ ).
+If so make sure to install all the dependencies listed in the "Installing prerequisites" sections of the installation instructions (`Windows <windows-install-binary-installing-prerequisites>`, `MacOS <osx-install-binary-installling-prerequisites>`).
 
 If you are installing from binaries, you may need to update your dependencies: they must be the same version as those used to build the binaries.

source/index.rst

@@ -49,7 +49,7 @@ ROS 2 is under heavy development.
 
 You can check out the `tutorials page <Tutorials>` to see a range of examples of what the system can do in its current state, if it fits your project *today* depending on the exact requirement.
 
-For details of the current features, see `Features <Features>`.
+For details of the current features, see `features status page <Features>`.
 
 If migrating code from ROS to ROS 2, check `the migration guide <Contributing/Migration-Guide>`.