Editing Development/Python (section)

== Docstrings ==

Every public class and function has a docstring. Docstrings include <code>Examples</code> blocks -- AI reads examples first to understand expected behavior.

<syntaxhighlight lang="python">
def resolve_legal_reference(raw_text: str) -> list[ResolvedReference]:
    """Parse a legal citation string into structured references.

    Runs a pipeline of detectors in priority order (most specific first).
    First match wins. Returns empty list if no pattern matches.

    Args:
        raw_text: A French legal citation in natural language.

    Returns:
        List of resolved references with canonical URIs.

    Examples:
        >>> resolve_legal_reference("article 1240 du code civil")
        [ResolvedReference(uri="fr.law.code.civil.article-1240")]

        >>> resolve_legal_reference("loi n° 85-677")
        [ResolvedReference(uri="fr.law.loi.85-677")]

        >>> resolve_legal_reference("bonjour")
        []
    """
</syntaxhighlight>