Skip to content

DOCS: Update Documentation for UI Redesign#187

Merged
zdomke merged 25 commits into
mainfrom
zdomke/docs-update
Sep 2, 2025
Merged

DOCS: Update Documentation for UI Redesign#187
zdomke merged 25 commits into
mainfrom
zdomke/docs-update

Conversation

@zdomke

@zdomke zdomke commented Aug 21, 2025

Copy link
Copy Markdown
Collaborator

Description

Updating the documentation pages for Trace. This consists of replacing content in the How To pages, restructuring the API Reference pages, and adding some extra features to the mkdocs.yml.

https://slaclab.github.io/trace/

Motivation

Our documentation should be as good or better than the code in our application.
Closes #4 and SWAPPS-320.

Pre-merge checklist

  • Code works interactively
  • Code contains descriptive docstrings

@zdomke zdomke self-assigned this Aug 21, 2025
@zdomke zdomke added documentation Improvements or additions to documentation CI/CD Improvements or additions to CI/CD pipeline labels Aug 21, 2025
@zdomke zdomke linked an issue Aug 22, 2025 that may be closed by this pull request
@zdomke zdomke added this to the Trace 1.5 milestone Aug 22, 2025
@zdomke zdomke force-pushed the zdomke/docs-update branch from 2ca37d0 to 1f9935b Compare August 25, 2025 16:39
@zdomke

zdomke commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator Author

Opening for review now. The documentation is not complete, but it is in a good state now to launch. Will add more doc updates in another PR.

@zdomke zdomke marked this pull request as ready for review September 2, 2025 17:19
@zdomke zdomke requested a review from a team September 2, 2025 17:20
@zdomke

zdomke commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator Author

Moving forward, users should include docstrings on their functions (and possibly classes). We are following the numpydoc format.

@zdomke zdomke merged commit 810a5dd into main Sep 2, 2025
4 checks passed
@zdomke zdomke mentioned this pull request Sep 2, 2025
2 tasks
@zdomke zdomke mentioned this pull request Sep 17, 2025
2 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI/CD Improvements or additions to CI/CD pipeline documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] - Publish Documentation Workflow Failing Build site for documentation

2 participants