minor: Use single backticks

Author: stephane-caron

CONTRIBUTING.md

@@ -7,19 +7,19 @@ The goal of this project is to facilitate loading and sharing of robot descripti
 
 - [Add a new robot description](#adding-a-new-robot-description)
 - Raise any issue you find in a description, preferably directly in the description's repository (check out [`_repositories.py`](https://github.com/stephane-caron/robot_descriptions.py/blob/main/robot_descriptions/_repositories.py))
-- Make a standalone ``<robot_name>_description`` repository for a description embedded in one of the big framework repositories (Bullet, Drake, ...)
+- Make a standalone `<robot_name>_description` repository for a description embedded in one of the big framework repositories (Bullet, Drake, ...)
 
 ## Adding a new robot description
 
 1. **License:** The robot description is distributed legally and under an open source license (permissive or copyleft).
-2. **Repository:** If needed, add the repository containing the new description to ``_repositories.py``.
+2. **Repository:** If needed, add the repository containing the new description to `_repositories.py`.
     - Use a specific git commit ID. This way the robot description will still work in the interval between a change in the file structure of the target repository and the corresponding update in `robot_descriptions`.
-3. **Submodule:** add a Python file for the robot descriptions to ``robot_descriptions/``.
-    - The file name for the new submodule is ``<robot_name>_description.py`` in snake-case.
-    - For example, the file name for the Kinova (maker) Gen2 (robot name) is ``gen2_description.py``.
-    - Use the ``mj_description`` suffix for an MJCF description.
-4. **Listing:** Add the description metadata to the ``DESCRIPTIONS`` dictionary in ``_descriptions.py``.
+3. **Submodule:** add a Python file for the robot descriptions to `robot_descriptions/`.
+    - The file name for the new submodule is `<robot_name>_description.py` in snake-case.
+    - For example, the file name for the Kinova (maker) Gen2 (robot name) is `gen2_description.py`.
+    - Use the `mj_description` suffix for an MJCF description.
+4. **Listing:** Add the description metadata to the `DESCRIPTIONS` dictionary in `_descriptions.py`.
 5. **README:** Document the description's submodule name in the Descriptions section of the [README](README.md).
     - Use an [SPDX License Identifier](https://spdx.org/licenses/) in the License column.
 6. **CHANGELOG:** Write down the new model at the top of the [changelog](CHANGELOG.md).
-7. **Testing:** Check that all unit tests are successful by ``tox``.
+7. **Testing:** Check that all unit tests are successful by `tox`.

README.md

@@ -54,7 +54,7 @@ Loading will automatically download the robot description if needed, and cache i
 
 ### Import as submodule
 
-You can also import a robot description directly as a submodule of ``robot_descriptions``:
+You can also import a robot description directly as a submodule of `robot_descriptions`:
 
 ```python
 from robot_descriptions import my_robot_description
@@ -83,7 +83,7 @@ The import will automatically download the robot description if you don't have i
     </dd>
 </dl>
 
-Some robot descriptions include additional fields. For instance, the ``iiwa14_description`` exports ``URDF_PATH_POLYTOPE_COLLISION`` with more detailed collision meshes.
+Some robot descriptions include additional fields. For instance, the `iiwa14_description` exports `URDF_PATH_POLYTOPE_COLLISION` with more detailed collision meshes.
 
 ## Examples
 

examples/show_in_meshcat.py

@@ -16,7 +16,7 @@
 try:
     from pinocchio.visualize import MeshcatVisualizer
 except ImportError as e:
-    raise ImportError("Pinocchio not found, try ``pip install pin``") from e
+    raise ImportError("Pinocchio not found, try `pip install pin`") from e
 
 from robot_descriptions.loaders.pinocchio import load_robot_description
 

examples/show_in_pybullet.py

@@ -7,7 +7,7 @@
 """
 Show a robot description, specified from the command line, using PyBullet.
 
-This example requires PyBullet, which is installed by ``pip install pybullet``.
+This example requires PyBullet, which is installed by `pip install pybullet`.
 """
 
 import argparse

examples/show_in_yourdfpy.py

@@ -8,13 +8,12 @@
 Show a robot description, specified from the command line, using yourdfpy.
 
 Note:
-    See ``robot_descriptions/_command_line.py`` for a more advanced
-    implementation, including the ability to set the robot configuration or
-    show collision meshes.
+    You can also use `python -m robot_descriptions show_in_yourdfpy` from the
+    command line.
 
 This example requires `yourdfpy` which is an optional dependency. It can be
 installed separately (``pip install yourdfpy``), or when robot descriptions are
-installed with optional dependencies ``pip install robot_descriptions[opts]``.
+installed with optional dependencies `pip install robot_descriptions[opts]`.
 """
 
 import argparse