Skip to content

feat: Add Sphinx documentation for the project#20

Open
joereg4 wants to merge 1 commit intoPokemonTCG:masterfrom
joereg4:new-documentation
Open

feat: Add Sphinx documentation for the project#20
joereg4 wants to merge 1 commit intoPokemonTCG:masterfrom
joereg4:new-documentation

Conversation

@joereg4
Copy link
Copy Markdown

@joereg4 joereg4 commented Jul 13, 2025

This pull request introduces a comprehensive documentation site for the pokemon-tcg-sdk-python project, generated using Sphinx. The official pokemontcg.io website mentioned that documentation was "coming soon," so this aims to fill that gap.

Key Features

  • Sphinx Framework: A complete Sphinx setup is included in the /docs directory.
  • Getting Started Guide: Includes pages for Installation and a Getting Started tutorial that covers API key configuration and basic usage.
  • Auto-Generated API Reference: The documentation now includes a full API reference, automatically generated from the existing docstrings in the code using sphinx.ext.autodoc.
  • Easy to Maintain: A new make docs command has been added to the Makefile, which builds the HTML documentation and opens it in a browser, making it easy to review and maintain.

How to Review

  1. Check out this branch.
  2. Run make setup to ensure all dependencies are installed.
  3. Run make docs from the project root.

This will build the documentation and open the main page (docs/_build/html/index.html) in your default browser.

This new documentation should make the SDK much more approachable for new users. Let me know if you have any feedback!

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.

1 participant