← GDG /

#113 gdtest_config_ug_list

#113 gdtest_config_ug_list OK CONFIG
Tests user_guide config as an explicit list of section dicts with titles and contents.
Tests user_guide as explicit list of sections with pages. Config defines exact ordering: 'Getting Started' (install, quickstart) then 'Advanced' (customization). Sidebar should show this structure.
View Site → Build Log ๐Ÿงช Test Coverage

Build Mode

● Has great-docs.yml

This package ships a pre-supplied config. The great-docs init step is skipped and great-docs build uses the spec-defined configuration directly. Tests specific config options and their rendered output.

Dimensions

K20
K20user_guide: listconfig

Source Files

๐Ÿ“ gdtest_config_ug_list/
๐Ÿ“„ __init__.py
"""Test package for user_guide list config."""
๐Ÿ“„ core.py
"""Core setup and run functions."""


def setup(config: dict) -> None:
    """Set up the application with the given configuration.

    Parameters
    ----------
    config : dict
        A dictionary containing configuration options.

    Examples
    --------
    >>> setup({"debug": True})
    """
    pass


def run(task: str) -> str:
    """Run a named task and return the result.

    Parameters
    ----------
    task : str
        The name of the task to execute.

    Returns
    -------
    str
        The result of executing the task.

    Examples
    --------
    >>> run("build")
    'build complete'
    """
    return f"{task} complete"
๐Ÿ“ user_guide/
๐Ÿ“„ customization.qmd
---
title: Customization
---

# Customization

Advanced customization options.
๐Ÿ“„ install.qmd
---
title: Installation
---

# Installation

How to install the package.
๐Ÿ“„ quickstart.qmd
---
title: Quickstart
---

# Quickstart

Get started quickly with this guide.
๐Ÿ“„ great-docs.yml
user_guide:
  - title: Getting Started
    contents:
      - install.qmd
      - quickstart.qmd
  - title: Advanced
    contents:
      - customization.qmd