DOC: RST to Markdown

The conversion is definitely not complete.

plotnine/_mpl/_plot_side_space.py

@@ -4,8 +4,8 @@
 titles and offsetboxes that are anchored to axes are currently considered.
 
 Internally, this module assumes that the margins (left margin, etc.) which are
-differences between ``Axes.get_tightbbox`` and ``Axes.bbox`` are independent of
-Axes position. This may fail if ``Axes.adjustable`` is ``datalim`` as well as
+differences between `Axes.get_tightbbox` and `Axes.bbox` are independent of
+Axes position. This may fail if `Axes.adjustable` is `datalim` as well as
 such cases as when left or right margin are affected by xlabel.
 """
 from __future__ import annotations

plotnine/_mpl/_plotnine_tight_layout.py

@@ -4,8 +4,8 @@
 titles and offsetboxes that are anchored to axes are currently considered.
 
 Internally, this module assumes that the margins (left margin, etc.) which are
-differences between ``Axes.get_tightbbox`` and ``Axes.bbox`` are independent of
-Axes position. This may fail if ``Axes.adjustable`` is ``datalim`` as well as
+differences between `Axes.get_tightbbox` and `Axes.bbox` are independent of
+Axes position. This may fail if `Axes.adjustable` is `datalim` as well as
 such cases as when left or right margin are affected by xlabel.
 """
 from __future__ import annotations

plotnine/coords/coord.py

@@ -99,7 +99,7 @@ def aspect(self, panel_params: panel_view) -> float | None:
         Return desired aspect ratio for the plot
 
         If not overridden by the subclass, this method
-        returns ``None``, which means that the coordinate
+        returns `None`, which means that the coordinate
         system does not influence the aspect ratio.
         """
         return None

plotnine/coords/coord_cartesian.py

@@ -27,16 +27,13 @@ class coord_cartesian(coord):
 
     Parameters
     ----------
-    xlim : None | (float, float)
-        Limits for x axis. If None, then they are
-        automatically computed.
-    ylim : None | (float, float)
-        Limits for y axis. If None, then they are
-        automatically computed.
-    expand : bool
-        If `True`, expand the coordinate axes by
-        some factor. If `False`, use the limits
-        from the data.
+    xlim : tuple[float, float], default=None
+        Limits for x axis. If None, then they are automatically computed.
+    ylim : tuple[float, float], default=None
+        Limits for y axis. If None, then they are automatically computed.
+    expand : bool, default=True
+        If `True`, expand the coordinate axes by some factor. If `False`,
+        use the limits from the data.
     """
 
     is_linear = True

plotnine/coords/coord_fixed.py

@@ -19,24 +19,22 @@ class coord_fixed(coord_cartesian):
     ----------
     ratio : float
         Desired aspect_ratio (:math:`y/x`) of the panel(s).
-        Default is 1.
-    xlim : None | (float, float)
-        Limits for x axis. If None, then they are
-        automatically computed.
-    ylim : None | (float, float)
-        Limits for y axis. If None, then they are
-        automatically computed.
-    expand : bool
-        If `True`, expand the coordinate axes by
-        some factor. If `False`, use the limits
-        from the data.
+    xlim : tuple[float, float], default=None
+        Limits for x axis. If None, then they are automatically computed.
+    ylim : tuple[float, float], default=None
+        Limits for y axis. If None, then they are automatically computed.
+    expand : bool, default=True
+        If `True`, expand the coordinate axes by some factor. If `False`,
+        use the limits from the data.
 
     Notes
     -----
     To specify aspect ratio of the visual size for the axes use the
-    [](`~plotnine.themes.themeable.aspect_ratio`) themeable::
+    [](`~plotnine.themes.themeable.aspect_ratio`) themeable.
 
-        ggplot(data, aes('x', 'y')) + theme(aspect_ratio=0.5)
+    ```python
+    ggplot(data, aes('x', 'y')) + theme(aspect_ratio=0.5)
+    ```
 
     When changing the `aspect_ratio` in either way, the `width` of the
     panel remains constant (as derived from the

plotnine/coords/coord_flip.py

@@ -21,23 +21,19 @@ class coord_flip(coord_cartesian):
     """
     Flipped cartesian coordinates
 
-    The horizontal becomes vertical, and vertical becomes
-    horizontal. This is primarily useful for converting
-    geoms and statistics which display y conditional
-    on x, to x conditional on y.
+    The horizontal becomes vertical, and vertical becomes horizontal.
+    This is primarily useful for converting geoms and statistics which
+    display y conditional on x, to x conditional on y.
 
     Parameters
     ----------
-    xlim : None | (float, float)
-        Limits for x axis. If None, then they are
-        automatically computed.
-    ylim : None | (float, float)
-        Limits for y axis. If None, then they are
-        automatically computed.
-    expand : bool
-        If `True`, expand the coordinate axes by
-        some factor. If `False`, use the limits
-        from the data.
+    xlim : tuple[float, float], default=None
+        Limits for x axis. If None, then they are automatically computed.
+    ylim : tuple[float, float], default=None
+        Limits for y axis. If None, then they are automatically computed.
+    expand : bool, default=True
+        If `True`, expand the coordinate axes by some factor. If `False`,
+        use the limits from the data.
     """
 
     def labels(self, cur_labels: labels_view) -> labels_view:

plotnine/coords/coord_trans.py

@@ -32,21 +32,16 @@ class coord_trans(coord):
     Parameters
     ----------
     x : str | trans
-        Name of transform or `trans` class to
-        transform the x axis
+        Name of transform or `trans` class to transform the x axis
     y : str | trans
-        Name of transform or `trans` class to
-        transform the y axis
-    xlim : None | (float, float)
-        Limits for x axis. If None, then they are
-        automatically computed.
-    ylim : None | (float, float)
-        Limits for y axis. If None, then they are
-        automatically computed.
-    expand : bool
-        If `True`, expand the coordinate axes by
-        some factor. If `False`, use the limits
-        from the data.
+        Name of transform or `trans` class to transform the y axis
+    xlim : tuple[float, float], default=None
+        Limits for x axis. If None, then they are automatically computed.
+    ylim : tuple[float, float], default=None
+        Limits for y axis. If None, then they are automatically computed.
+    expand : bool, default=True
+        If `True`, expand the coordinate axes by some factor. If `False`,
+        use the limits from the data.
     """
 
     trans_x: Trans