docs: conventions, mwe and docstring fixes (#3973)

pola-rs · Jul 11, 2022 · 35bb7bf · 35bb7bf
1 parent deac4b9
commit 35bb7bf
Show file tree

Hide file tree

Showing 9 changed files with 227 additions and 294 deletions.
diff --git a/py-polars/docs/source/reference/expression.rst b/py-polars/docs/source/reference/expression.rst
@@ -176,7 +176,6 @@ Manipulation/ selection
 
     Expr.append
     Expr.arg_sort
-    Expr.arg_sort
     Expr.argsort
     Expr.backward_fill
     Expr.cast
@@ -220,7 +219,7 @@ Column names
 ------------
    Expressions that help renaming/ selecting columns by name.
 
-   A wildcard `col("*")`/`pl.all()` selects all columns in a DataFrame.
+   A wildcard ``col("*")``/:func:`polars.all()` selects all columns in a DataFrame.
 
    >>> df.select(pl.all())
 

diff --git a/py-polars/polars/cfg.py b/py-polars/polars/cfg.py
@@ -71,7 +71,6 @@ def set_tbl_cols(cls, n: int) -> type[Config]:
 
         Examples
         --------
-
         >>> pl.cfg.Config.set_tbl_cols(5)
         >>> df = pl.DataFrame({str(i): [i] for i in range(100)})
         >>> df

diff --git a/py-polars/polars/convert.py b/py-polars/polars/convert.py
@@ -87,7 +87,6 @@ def from_dicts(
 
     Examples
     --------
-
     >>> data = [{"a": 1, "b": 4}, {"a": 2, "b": 5}, {"a": 3, "b": 6}]
     >>> df = pl.from_dicts(data)
     >>> df
@@ -136,7 +135,6 @@ def from_records(
 
     Examples
     --------
-
     >>> data = [[1, 2, 3], [4, 5, 6]]
     >>> df = pl.from_records(data, columns=["a", "b"])
     >>> df
@@ -193,7 +191,6 @@ def from_numpy(
 
     Examples
     --------
-
     >>> import numpy as np
     >>> data = np.array([[1, 2, 3], [4, 5, 6]])
     >>> df = pl.from_numpy(data, columns=["a", "b"], orient="col")