Skip to content

Add type hints and set up Sphinx documentation#61

Merged
skyelaird merged 2 commits intomainfrom
claude/add-types-sphinx-setup-016pU19nbb19tY7zeXekQDVV
Nov 15, 2025
Merged

Add type hints and set up Sphinx documentation#61
skyelaird merged 2 commits intomainfrom
claude/add-types-sphinx-setup-016pU19nbb19tY7zeXekQDVV

Conversation

@skyelaird
Copy link
Copy Markdown
Owner

No description provided.

Type Hints:
- Added type hints to src/dvoacap/__init__.py
  - get_phase_status() -> Dict[str, str]
  - get_version_info() -> Dict[str, Any]
- Fixed path_geometry.py to use Tuple from typing for Python 3.8 compatibility
  - Changed tuple[float, float] to Tuple[float, float]
  - Added Tuple import from typing module

Sphinx Documentation:
- Created docs/source/ directory structure
- Added docs/source/conf.py with comprehensive Sphinx configuration
  - Configured autodoc, napoleon, viewcode, intersphinx extensions
  - Set up Google/NumPy docstring support
  - Configured alabaster theme
- Created documentation pages:
  - index.rst: Main documentation page
  - api.rst: Complete API reference for all modules
  - overview.rst: Project overview and architecture
  - installation.rst: Installation instructions
  - quickstart.rst: Quick start guide with examples
  - examples.rst: Detailed code examples
- Added docs/Makefile for building documentation
- Added docs/README.md explaining documentation setup
- Created _static/ and _templates/ directories for Sphinx

All changes maintain Python 3.8+ compatibility and follow best practices.
Document planning notes from VOACAP manual review:
- Target DXCC selection and Maidenhead grid support
- Greyline propagation visualization
- Antenna selection including DX Commander
- Propagation and reliability chart tabs
- MUF analysis tools
- Coverage area maps with smoothing
- Mini planner functionality
- Data presentation philosophy
@skyelaird skyelaird merged commit 9b4a215 into main Nov 15, 2025
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