Skip to content

Add MkDocs documentation for ReadTheDocs#22

Merged
jpdeleon merged 1 commit into
mainfrom
upgrade
Apr 9, 2026
Merged

Add MkDocs documentation for ReadTheDocs#22
jpdeleon merged 1 commit into
mainfrom
upgrade

Conversation

@jpdeleon

@jpdeleon jpdeleon commented Apr 9, 2026

Copy link
Copy Markdown
Owner

Add complete project documentation using MkDocs with the Material theme, configured for ReadTheDocs hosting.

Pages:

  • Home: project overview, output figure example, usage summary
  • Installation: pip/conda/dev/GUI/notebook install instructions
  • Getting Started: quick examples for CLI, Python API, and web GUI
  • CLI Reference: full flag reference for ql, read_tls, rank_tls
  • Web GUI: job queue, each-sector mode, batch submission, gallery
  • Pipeline Overview: step-by-step pipeline description and explanation of all 9 diagnostic panels
  • API Reference: TessQuickLook constructor, attributes, methods, exceptions, and utility functions
  • Batch Processing: shell scripts, GNU parallel, post-processing with read_tls and rank_tls
  • FAQ: common errors, troubleshooting, parameter tuning

Config:

  • mkdocs.yml with Material theme (light/dark toggle), code copy, admonitions, and tabbed content
  • .readthedocs.yaml fixed (typo on line 1) and updated to install docs/requirements.txt
  • docs/requirements.txt pins mkdocs, mkdocs-material, pymdown-extensions
  • .gitignore updated to exclude site/ build output

Add complete project documentation using MkDocs with the Material theme,
configured for ReadTheDocs hosting.

Pages:
- Home: project overview, output figure example, usage summary
- Installation: pip/conda/dev/GUI/notebook install instructions
- Getting Started: quick examples for CLI, Python API, and web GUI
- CLI Reference: full flag reference for ql, read_tls, rank_tls
- Web GUI: job queue, each-sector mode, batch submission, gallery
- Pipeline Overview: step-by-step pipeline description and explanation
  of all 9 diagnostic panels
- API Reference: TessQuickLook constructor, attributes, methods,
  exceptions, and utility functions
- Batch Processing: shell scripts, GNU parallel, post-processing
  with read_tls and rank_tls
- FAQ: common errors, troubleshooting, parameter tuning

Config:
- mkdocs.yml with Material theme (light/dark toggle), code copy,
  admonitions, and tabbed content
- .readthedocs.yaml fixed (typo on line 1) and updated to install
  docs/requirements.txt
- docs/requirements.txt pins mkdocs, mkdocs-material, pymdown-extensions
- .gitignore updated to exclude site/ build output

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@jpdeleon jpdeleon merged commit b1f715c into main Apr 9, 2026
5 checks passed
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