Skip to content

Add comprehensive documentation with mkdocs-material and GitHub Pages deployment#5

Merged
inntran merged 1 commit into
developfrom
feature/add-documentation
Nov 6, 2025
Merged

Add comprehensive documentation with mkdocs-material and GitHub Pages deployment#5
inntran merged 1 commit into
developfrom
feature/add-documentation

Conversation

@inntran
Copy link
Copy Markdown
Owner

@inntran inntran commented Nov 6, 2025

Documentation Structure:

  • Getting Started: Installation, Quick Start, Authentication
  • User Guide: Client, Pools, Partners, Distributions, Certificates, History
  • API Reference: Client, Models, Resources, Exceptions
  • Contributing: Development Setup, Testing, Code Style
  • Changelog

Features:

  • mkdocs-material theme with dark/light mode
  • mike for multi-version documentation
  • GitHub Actions workflow for automatic deployment
  • Deploys to GitHub Pages on push to main/staging/develop
  • Version tagging support (v*)
  • Comprehensive code examples matching actual API
  • Search functionality and navigation tabs

Dependencies Added:

  • mkdocs>=1.6.0
  • mkdocs-material>=9.6.0
  • mike>=2.1.0

Deployment:

API Documentation:

  • Uses TMOClient and TMOException naming
  • Documents actual token/database parameters
  • Shows shares_pools/capital_pools structure
  • Includes all resource types and methods

🤖 Generated with Claude Code

… deployment

Documentation Structure:
- Getting Started: Installation, Quick Start, Authentication
- User Guide: Client, Pools, Partners, Distributions, Certificates, History
- API Reference: Client, Models, Resources, Exceptions
- Contributing: Development Setup, Testing, Code Style
- Changelog

Features:
- mkdocs-material theme with dark/light mode
- mike for multi-version documentation
- GitHub Actions workflow for automatic deployment
- Deploys to GitHub Pages on push to main/staging/develop
- Version tagging support (v*)
- Comprehensive code examples matching actual API
- Search functionality and navigation tabs

Dependencies Added:
- mkdocs>=1.6.0
- mkdocs-material>=9.6.0
- mike>=2.1.0

Deployment:
- main branch → latest + stable aliases
- staging branch → staging version
- develop branch → dev version
- version tags → versioned deployment
- Auto-deploys to https://inntran.github.io/tmo-api-python/

API Documentation:
- Uses TMOClient and TMOException naming
- Documents actual token/database parameters
- Shows shares_pools/capital_pools structure
- Includes all resource types and methods

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@inntran inntran changed the title Add comprehensive documentation with mkdocs-material and GitHub Pages Add comprehensive documentation with mkdocs-material and GitHub Pages deployment Nov 6, 2025
@codecov
Copy link
Copy Markdown

codecov Bot commented Nov 6, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@inntran inntran merged commit 3a3625f into develop Nov 6, 2025
7 checks passed
@inntran inntran deleted the feature/add-documentation branch November 6, 2025 18:48
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