Add llms.txt generation from XML docs and update build

[0xFirekeeper]

Introduces a new Makefile target 'generate-llms' to generate llms.txt from XML documentation using the generator project. Updates the build process to include llms.txt generation. Adds implementation in Thirdweb.Generator/Program.cs for parsing XML docs and outputting a formatted llms.txt file. Adds the initial generated llms.txt to the repository.

---

PR-Codex overview

This PR introduces a new generate-llms target in the Makefile and adds functionality to generate llms.txt from XML documentation in the C# project. It enhances the documentation generation process and improves the API client documentation.

Detailed summary

• Added generate-llms target in Makefile for generating llms.txt.
• Implemented GenerateLlmsTxt method to read XML documentation and create llms.txt.
• Introduced MemberSignature and ParameterInfo classes to structure documentation data.
• Enhanced error handling for missing XML documentation.
• Updated the console output for the generation process.

The following files were skipped due to too many changes: llms.txt

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

Summary by CodeRabbit

• New Features

  • API documentation can now be generated independently via command-line option.

• Chores

  • Automated API documentation generation from XML source comments integrated into build pipeline, executing automatically after successful compilation.

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This pull request adds a new build workflow to generate llms.txt from XML documentation. A Makefile target generate-llms is introduced to automate XML doc processing after successful builds. Thirdweb.Generator/Program.cs is enhanced with utility methods to parse member signatures, extract parameter metadata, and normalize type names into a structured text format.

Changes

Cohort / File(s)	Summary
Build process enhancement Makefile	Added new generate-llms target with .PHONY declaration. Modified build target to invoke generate-llms after compilation succeeds. Includes messaging for build phase and generation step, error handling, and updated help text documentation.
XML documentation processing utilities Thirdweb.Generator/Program.cs	Added GenerateLlmsTxt(string) method to read XML documentation and generate llms.txt with structured API member data. Introduced helper methods: ParseMemberSignature(string) to classify and parse member signatures, SplitParameters(string) for robust parameter list parsing, SimplifyTypeName(string) for type name normalization, and NormalizeXmlText(string) for documentation text formatting. Added internal classes MemberSignature and ParameterInfo for metadata modeling. Integrated new --llms command-line switch and imported System.Text and System.Xml.Linq namespaces. Modified program entry point to support llms.txt generation workflow.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Makefile as Makefile<br/>(build)
    participant DotNet as dotnet build
    participant Makefile2 as Makefile<br/>(generate-llms)
    participant Program as Program.cs<br/>--llms
    participant XML as Thirdweb.xml
    participant Output as llms.txt

    User->>Makefile: make build
    Makefile->>DotNet: dotnet build Release
    DotNet->>DotNet: Compile
    DotNet-->>Makefile: Success
    Makefile->>Makefile2: Invoke generate-llms
    Makefile2->>Program: Run with --llms flag
    Program->>XML: Read Thirdweb.xml
    XML-->>Program: XML content
    Note over Program: Parse signatures<br/>Extract metadata<br/>Normalize types
    Program->>Output: Write llms.txt
    Output-->>Makefile2: Generated
    Makefile2-->>Makefile: Success
    Makefile-->>User: Build + Documentation complete

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

• Member signature parsing logic: Requires verification that classification (Method, Property, Type, Field, Event) correctly handles edge cases and that parameter extraction is robust
• Generic type handling: The SplitParameters method must correctly balance nested angle brackets; review for correctness on complex nested generic signatures
• Type name simplification: SimplifyTypeName performs regex or string-based transformations; verify it handles all expected .NET type patterns and doesn't produce incorrect simplifications
• XML documentation reading: Confirm error handling when Thirdweb.xml is missing or malformed, and that the output format is well-formed

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch firekeeper/llmstxt

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between b26d6fa and cb5ab92.

📒 Files selected for processing (2)

• Makefile (2 hunks)
• Thirdweb.Generator/Program.cs (3 hunks)

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}