Skip to content

Conversation

TaylorGilg
Copy link
Contributor

@TaylorGilg TaylorGilg commented Jun 30, 2025

Summary

The Mkdocs documentation now uses the docstrings plugin to generate html pages from docstrings comments on code files. Documentation can now adapt to new code changes automatically.

  • I know main has changed a bit since I developed the first documentation pages so I'll probably go through and improve commenting and look into any files I'm currently missing. I'll also try to see if I can compact all the markdown files in the pysquared/pysquared/docs folder into one file.
  • Nate brought up utilizing AI to make our documentation even more accessible so next I'll look into how to create a type of deepwiki so people can ask questions to our source code.

How was this tested

  • Added new unit tests
  • Ran code on hardware (screenshots are helpful)
  • Other (Please describe)
Captura de pantalla 2025-07-07 a la(s) 19 39 23 Captura de pantalla 2025-07-07 a la(s) 19 39 21 Captura de pantalla 2025-07-07 a la(s) 19 39 19

@nateinaction nateinaction marked this pull request as ready for review July 7, 2025 23:55
@nateinaction nateinaction requested a review from Copilot July 7, 2025 23:55
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR replaces the existing hand-written Markdown docs in pysquared/docs with an auto-generated API reference using mkdocstrings and updates the MkDocs configuration to drive documentation from code comments.

  • Removed all static .md files under pysquared/docs/
  • Added root-level mkdocs.yml with mkdocstrings plugin configuration
  • Updated pyproject.toml, Makefile, and GitHub Actions for doc build/deploy

Reviewed Changes

Copilot reviewed 28 out of 29 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
pysquared/mkdocs.yml Deleted (old docs config removed in favor of root mkdocs.yml)
pysquared/docs/* Deleted all static docs (to be auto-generated)
mkdocs.yml New root config pointing at code docstrings via mkdocstrings
pyproject.toml Added mkdocstrings and section-index dependencies
Makefile Updated docs and docs-deploy targets
.github/workflows/docs.yaml New workflow to trigger make docs-deploy on push to main
pysquared/config/radio.py Added detailed docstrings for RadioConfig classes
pysquared/config/config.py Added detailed docstrings for Config class

Copy link

sonarqubecloud bot commented Jul 8, 2025

Copy link
Member

@nateinaction nateinaction left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's try it!

@nateinaction nateinaction merged commit b0068a0 into main Jul 8, 2025
5 checks passed
@nateinaction nateinaction deleted the docscript branch July 8, 2025 00:40
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