Links
AI / Agents
gdtest-user-guide-custom-dir
A synthetic test package with custom user guide directory.
User guide lives in docs/guides/ instead of user_guide/. The config specifies user_guide: ‘docs/guides’. In the sidebar you should see user guide pages from this custom directory. Two functions (fetch, store) should appear on the Reference page.
Source files
docs/
guides/
advanced.qmd
--- title: Advanced --- Advanced topics.
intro.qmd
--- title: Introduction --- Welcome to the custom guide!
gdtest_user_guide_custom_dir/
__init__.py
"""A test package with custom user guide directory."""
__version__ = "0.1.0"
__all__ = ["fetch", "store"]
def fetch(url: str) -> str:
"""
Fetch data from a URL.
Parameters
----------
url
The URL to fetch from.
Returns
-------
str
Fetched data.
"""
return ""
def store(data: str, path: str) -> None:
"""
Store data to a path.
Parameters
----------
data
Data to store.
path
Storage path.
"""
passREADME.md
# gdtest-user-guide-custom-dir A synthetic test package with custom user guide directory.
great-docs.yml
user_guide: docs/guides