-
Notifications
You must be signed in to change notification settings - Fork 28
Ssh/docgen #88
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Ssh/docgen #88
Conversation
495148c to
ca51c57
Compare
Codecov Report❌ Patch coverage is
Additional details and impacted files@@ Coverage Diff @@
## main #88 +/- ##
==========================================
- Coverage 84.10% 84.06% -0.05%
==========================================
Files 42 42
Lines 2001 2002 +1
==========================================
Hits 1683 1683
- Misses 318 319 +1 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
ca51c57 to
ecfd644
Compare
There was a problem hiding this 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 implements comprehensive documentation generation for the PRAS (Probabilistic Resource Adequacy Suite) project. The documentation covers installation, user guides, API references, and examples for the complete PRAS ecosystem including its modular packages.
Key changes:
- Added complete documentation structure with installation, quick start, and detailed component guides
- Implemented API documentation for PRASCore, PRASFiles, and PRASCapacityCredits packages
- Added GitHub Actions workflows for automated documentation building and deployment
Reviewed Changes
Copilot reviewed 35 out of 40 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/src/*.md | Core documentation pages including installation, quick start, resource adequacy background, and extending PRAS |
| docs/src/PRAS/*.md | Detailed component documentation for system models, simulations, results, and capacity credits |
| docs/src/PRASCore/*.md | API documentation for the core PRAS functionality |
| docs/src/PRASFiles/*.md | API documentation for file handling capabilities |
| docs/src/PRASCapacityCredits/*.md | API documentation for capacity credit calculations |
| docs/make.jl | Documentation build configuration using Documenter.jl |
| .github/workflows/*.yml | GitHub Actions for automated documentation deployment and cleanup |
| PRASCore.jl/src/Systems/*.jl | Added comprehensive docstrings for system model components |
| PRAS.jl/examples/pras_walkthrough.jl | Complete tutorial example using RTS-GMLC system |
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
docs/src/resourceadequacy.md
Outdated
| An electrical power system is considered resource adequate if it has procured | ||
| sufficient resources (including supply, transmission, and responsive demand) | ||
| such that it runs a sufficiently low risk of invoking emergency measures (such | ||
| as involuntary load shedding) due to resource unavailablity or deliverability |
Copilot
AI
Sep 25, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is a spelling error: 'unavailablity' should be 'unavailability'.
| as involuntary load shedding) due to resource unavailablity or deliverability | |
| as involuntary load shedding) due to resource unavailability or deliverability |
docs/src/quickstart.md
Outdated
|
|
||
| ## Power System Data | ||
|
|
||
| The recommended way to store and retreive PRAS system data is in an HDF5 file that conforms to the [PRAS system data format](./SystemModel_HDF5_spec.md). Once your system is represented in that format you can load it into PRAS with: |
Copilot
AI
Sep 25, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There is a spelling error: 'retreive' should be 'retrieve'.
| The recommended way to store and retreive PRAS system data is in an HDF5 file that conforms to the [PRAS system data format](./SystemModel_HDF5_spec.md). Once your system is represented in that format you can load it into PRAS with: | |
| The recommended way to store and retrieve PRAS system data is in an HDF5 file that conforms to the [PRAS system data format](./SystemModel_HDF5_spec.md). Once your system is represented in that format you can load it into PRAS with: |
docs/src/quickstart.md
Outdated
|
|
||
| ## Capacity Credit Calculations | ||
|
|
||
| Capacity credit calcuations build on probabilistic resource adequacy assessment to provided capacity-based quantifications of the marginal benefit to system resource adequacy associated with a specific resource or collection of resources. Two capacity credit metrics (EFC and ELCC) are currently supported. |
Copilot
AI
Sep 25, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There are spelling/grammar errors: 'calcuations' should be 'calculations' and 'to provided' should be 'to provide'.
| Capacity credit calcuations build on probabilistic resource adequacy assessment to provided capacity-based quantifications of the marginal benefit to system resource adequacy associated with a specific resource or collection of resources. Two capacity credit metrics (EFC and ELCC) are currently supported. | |
| Capacity credit calculations build on probabilistic resource adequacy assessment to provide capacity-based quantifications of the marginal benefit to system resource adequacy associated with a specific resource or collection of resources. Two capacity credit metrics (EFC and ELCC) are currently supported. |
8a5ae59 to
6ebb0a9
Compare
e0be86d to
845b149
Compare
No description provided.