[create_python_library.rst] Adjusted for Jazzy.

Author: mmmarinho

docs/source/create_python_library.rst

@@ -17,11 +17,11 @@ which outputs the forever beautiful wall of text we're now used to, with a minor
 
    going to create a new package
    package name: python_package_with_a_library
-   destination directory: /home/murilo/git/ROS2_Tutorial/ros2_tutorial_workspace/src
+   destination directory: /root/ros2_tutorial_workspace/src
    package format: 3
    version: 0.0.0
    description: TODO: Package description
-   maintainer: ['murilo <murilomarinho@ieee.org>']
+   maintainer: ['root <murilo.marinho@manchester.ac.uk>']
    licenses: ['TODO: License declaration']
    build type: ament_python
    dependencies: []
@@ -43,7 +43,7 @@ which outputs the forever beautiful wall of text we're now used to, with a minor
    creating ./python_package_with_a_library/python_package_with_a_library/sample_python_library/__init__.py
 
    [WARNING]: Unknown license 'TODO: License declaration'.  This has been set in the package.xml, but no LICENSE file has been created.
-   It is recommended to use one of the ament license identitifers:
+   It is recommended to use one of the ament license identifiers:
    Apache-2.0
    BSL-1.0
    BSD-2.0
@@ -58,21 +58,25 @@ The folders/files, Mason, what do they mean?
 --------------------------------------------
 
 The ROS2 package created from the template has a structure like so. In particular, we can see that :file:`python_package_with_a_library` is repeated twice in a row. This is a common source of error, so don't forget!
+The first is the name of the :program:`ROS2` package, and the second is the name of Python package that will be installed by :program:`ROS2`.
 
 .. code-block:: console
-   :emphasize-lines: 1,2
+   :emphasize-lines: 1,3
    
-   python_package_with_a_library
-      └── python_package_with_a_library
-         └── sample_python_library
-            __init__.py
-         __init__.py
-      └── resource
-         python_package_with_a_library
-      └── test
-      package.xml
-      setup.cfg
-      setup.py
+   python_package_with_a_library/
+   |-- package.xml
+   |-- python_package_with_a_library
+   |   |-- __init__.py
+   |   `-- sample_python_library
+   |       `-- __init__.py
+   |-- resource
+   |   `-- python_package_with_a_library
+   |-- setup.cfg
+   |-- setup.py
+   `-- test
+       |-- test_copyright.py
+       |-- test_flake8.py
+       `-- test_pep257.py
       
 We learned the meaning of most of those in the preamble, namely :ref:`Python Best Practices`. To quickly clarify a few things, see the table below.
 
@@ -105,17 +109,24 @@ Overview of the library
 For the sake of the example, let us create a library with a Python :code:`function` and another one with a :code:`class`. To guide our next steps, we first draw a quick overview of what our :code:`python_package_with_a_library` will look like.
 
 .. code-block:: console
-   :emphasize-lines: 4,5,6
+   :emphasize-lines: 6-8
    
-   python_package_with_a_library
-      └── python_package_with_a_library
-         └── sample_python_library
-            __init__.py
-            _sample_class.py
-            _sample_function.py
-         __init__.py
-      └── resource
-      └── test
+   python_package_with_a_library/
+   |-- package.xml
+   |-- python_package_with_a_library
+   |   |-- __init__.py
+   |   `-- sample_python_library
+   |       |-- __init__.py
+   |       |-- _sample_class.py
+   |       `-- _sample_function.py
+   |-- resource
+   |   `-- python_package_with_a_library
+   |-- setup.cfg
+   |-- setup.py
+   `-- test
+       |-- test_copyright.py
+       |-- test_flake8.py
+       `-- test_pep257.py
       
 With respect to the highlighted files, we will
 
@@ -152,35 +163,6 @@ Create a new file with the following contents and name.
    :lines: 26-
 
 The class is quite simple with a `private data member <https://docs.python.org/3/tutorial/classes.html#private-variables>`_ and a method to retrieve it.
-   
-Modify the :code:`__init__.py` to export the symbols
-----------------------------------------------------
-
-With the necessary files created and properly organized, the last step is to :code:`import` the function and the class. We modify proper :file:`__init__.py` file with the following contents.
-
-:download:`~/ros2_tutorial_workspace/src/python_package_with_a_library/python_package_with_a_library/sample_python_library/__init__.py <../../ros2_tutorial_workspace/src/python_package_with_a_library/python_package_with_a_library/sample_python_library/__init__.py>`
-
-.. literalinclude:: ../../ros2_tutorial_workspace/src/python_package_with_a_library/python_package_with_a_library/sample_python_library/__init__.py
-   :language: python
-   :linenos:
-   :lines: 24-
-
-Modify the :code:`setup.py` to export the packages
---------------------------------------------------
-
-.. warning::
-   This step might be unnecessary after `this fix <https://github.com/ros2/ros2cli/issues/833>`_.
-
-.. note::
-
-   This is a *one-size-fits-most* solution, which might not work for certain Python package structures. As a generic solution, we will export all Python packages in the ROS2 package excluding the `test` directory. For more information on :program:`setuptools`, see the `official Python packaging docs <https://packaging.python.org/en/latest/guides/distributing-packages-using-setuptools/>`_.
-
-:download:`~/ros2_tutorial_workspace/src/python_package_with_a_library/setup.py <../../ros2_tutorial_workspace/src/python_package_with_a_library/setup.py>`
-
-.. literalinclude:: ../../ros2_tutorial_workspace/src/python_package_with_a_library/setup.py
-   :language: python
-   :linenos:
-   :emphasize-lines: 1,8
 
 Build and source
 ----------------