Skip to content

feat(documentation): added llms.txt, examples and referenced these artifacts via README#748

Merged
james-rl merged 6 commits intomainfrom
james/llms-txt
Mar 2, 2026
Merged

feat(documentation): added llms.txt, examples and referenced these artifacts via README#748
james-rl merged 6 commits intomainfrom
james/llms-txt

Conversation

@james-rl
Copy link
Contributor

@james-rl james-rl commented Mar 2, 2026

This adds a generator for a consolidated, short list of recipes that external agents can reference using EXAMPLES.md. Also adds an llms.txt and updates the README.md to reference the new artifacts.

This puts the python client in approx parity with the ts client.

The purpose of this entire change is to create recipe-style examples that LLMs can look at to improve their performance when using our SDKs and APIs.

@james-rl james-rl requested a review from dines-rl March 2, 2026 21:22
@james-rl james-rl requested a review from sid-rl March 2, 2026 21:45
Copy link
Contributor

@sid-rl sid-rl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some minor code duplication concerns but looks good otherwise! make sure example scripts are runnable before merging

return result.skipped or has_failed_checks or len(result.cleanup_status.failed) > 0


def wrap_recipe(
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

basically a duplicate of wrap_recipe_with_options right? could we clean up/refactor?

from .example_types import ExampleCheck, RecipeOutput, RecipeContext


def unique_name(prefix: str) -> str:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

defined in both example files, maybe can just be implemented in _harness.py?

@james-rl james-rl merged commit bceb953 into main Mar 2, 2026
7 checks passed
@james-rl james-rl deleted the james/llms-txt branch March 2, 2026 23:32
@stainless-app stainless-app bot mentioned this pull request Mar 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants