Skip to content

Electrical Component Docstrings #41

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

Merged
merged 3 commits into from
Apr 28, 2022

Conversation

AayushSabharwal
Copy link
Member

Copied over from #7 without the git issues.

@ChrisRackauckas
Copy link
Member

Can you also add the new docstrings to https://github.com/SciML/ModelingToolkitStandardLibrary.jl/blob/main/docs/src/API/electrical.md ?

@codecov
Copy link

codecov bot commented Apr 28, 2022

Codecov Report

Merging #41 (f74f1d4) into main (4b081e6) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main      #41   +/-   ##
=======================================
  Coverage   69.03%   69.03%           
=======================================
  Files          23       23           
  Lines         956      956           
=======================================
  Hits          660      660           
  Misses        296      296           
Impacted Files Coverage Δ
src/Electrical/Analog/ideal_components.jl 100.00% <ø> (ø)
src/Electrical/Analog/sensors.jl 56.41% <ø> (ø)
src/Electrical/Analog/sources.jl 100.00% <ø> (ø)
src/Electrical/Digital/components.jl 0.00% <ø> (ø)
src/Electrical/Digital/gates.jl 0.00% <ø> (ø)
src/Electrical/Digital/sources.jl 0.00% <ø> (ø)
src/Electrical/utils.jl 61.53% <ø> (ø)

📣 Codecov can now indicate which changes are the most critical in Pull Requests. Learn more


# States
- `v(t)`: [`V`]
The voltage across the capacitor, given by `D(v) ~ p.i / C`
Copy link
Contributor

Choose a reason for hiding this comment

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

The states are actually inherited from the OnePort component, hence they are v and i. Maybe a @ref would do it.

@ValentinKaisermayer
Copy link
Contributor

Can you also add the new docstrings to https://github.com/SciML/ModelingToolkitStandardLibrary.jl/blob/main/docs/src/API/electrical.md ?

The Digital stuff isn't tested and the include is commended out, so the doc build will fail I think.

@AayushSabharwal
Copy link
Member Author

Documenter doesn't fail when docstrings aren't defined, it throws a warning and renders an error message in the docs, which appears to be what's happening here judging by the CI logs.

@ChrisRackauckas
Copy link
Member

IMO, let's merge this and let it throw a warning in the docs for now. It will leave clear markers of what needs to be finished still, but let people know it's coming soon.

@ChrisRackauckas ChrisRackauckas merged commit e5e6ab7 into SciML:main Apr 28, 2022
@AayushSabharwal AayushSabharwal deleted the new_docstrings branch July 21, 2023 10:43
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.

3 participants