Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@zdomke
Copy link
Collaborator

@zdomke zdomke commented Aug 21, 2025

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
Copy link
Collaborator Author

zdomke commented Sep 2, 2025

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
Copy link
Collaborator Author

zdomke commented Sep 2, 2025

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

3 participants