Skip to content

Commit 0477db5

Browse files
committed
ci: Don't use parameter headings insiders feature since it breaks in CI
1 parent 39a1174 commit 0477db5

File tree

3 files changed

+3
-3
lines changed

3 files changed

+3
-3
lines changed

docs/guide/users/loading.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ Reusing the same loader will also help resolving aliases across different packag
7272

7373
## Search paths
7474

75-
To specify in which directories Griffe should search for packages and modules, you can use the `search_paths` parameter on both the [`load` function][griffe.load(search_paths)] and the [`GriffeLoader` class][griffe.GriffeLoader(search_paths)].
75+
To specify in which directories Griffe should search for packages and modules, you can use the `search_paths` parameter on both the [`load` function][griffe.load] and the [`GriffeLoader` class][griffe.GriffeLoader].
7676

7777
=== "`load`"
7878

docs/guide/users/navigating.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -337,7 +337,7 @@ Each object has an optional [`docstring`][griffe.Object.docstring] attached to i
337337

338338
Docstrings can be parsed against several [docstring-styles](../../reference/docstrings.md), which are micro-formats that allow documenting things such as parameters, returned values, raised exceptions, etc..
339339

340-
When loading a package, it is possible to specify the docstring style to attach to every docstring (see [`griffe.load(docstring_parser)`][griffe.load(docstring_parser)]). Accessing the [`parsed`][griffe.Docstring.parsed] field of a docstring will use this style to parse the docstring and return a list of [docstring sections][advanced-api-sections]. Each section has a `value` whose shape depend on the section kind. For example, parameter sections have a list of parameter representations as value, while a text section only has a string as value.
340+
When loading a package, it is possible to specify the docstring style to attach to every docstring (see the `docstring_parser` parameter of [`griffe.load`][griffe.load]). Accessing the [`parsed`][griffe.Docstring.parsed] field of a docstring will use this style to parse the docstring and return a list of [docstring sections][advanced-api-sections]. Each section has a `value` whose shape depend on the section kind. For example, parameter sections have a list of parameter representations as value, while a text section only has a string as value.
341341

342342
After a package is loaded, it is still possible to change the style used for specific docstrings by either overriding their [`parser`][griffe.Docstring.parser] and [`parser_options`][griffe.Docstring.parser_options] attributes, or by calling their [`parse()`][griffe.Docstring.parse] method with a different style:
343343

src/_griffe/finder.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ class ModuleFinder:
9595
The module finder is generally not used directly.
9696
Each [`GriffeLoader`][griffe.GriffeLoader] instance creates its own module finder instance.
9797
The finder can be configured when instantiating the loader
98-
thanks to the loader [`search_paths`][griffe.GriffeLoader(search_paths)] parameter.
98+
thanks to the [loader][griffe.GriffeLoader]'s `search_paths` parameter.
9999
"""
100100

101101
accepted_py_module_extensions: ClassVar[list[str]] = [".py", ".pyc", ".pyo", ".pyd", ".pyi", ".so"]

0 commit comments

Comments
 (0)