Skip to content
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

docs: Fix spec objects parameter definitions #2024

Merged
merged 1 commit into from
Feb 16, 2024

Conversation

jsumners-nr
Copy link
Contributor

This PR fixes some issues with the docs on the recently added spec objects. When I got to some specs that only add one or two parameters to the subclass I forgot why I was using a typedef for the constructor parameters and wrote them inline. This was a mistake. Each subclass's parameters should augment the parent class's parameters. We can only do that with typedef blocks for the parameters.

As I was fixing this issue, I discovered that the @augments tag does not inline the parent definition's properties, nor provide a link back to the definition. The @mixes tag at least provides a link.

Verified

This commit was signed with the committer’s verified signature.
jsumners-nr James Sumners
Copy link

codecov bot commented Feb 16, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (ff78b51) 97.11% compared to head (8f588e4) 97.11%.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2024   +/-   ##
=======================================
  Coverage   97.11%   97.11%           
=======================================
  Files         239      239           
  Lines       41066    41108   +42     
=======================================
+ Hits        39880    39922   +42     
  Misses       1186     1186           
Flag Coverage Δ
integration-tests-16.x 78.72% <100.00%> (+0.01%) ⬆️
integration-tests-18.x 78.72% <94.02%> (+0.03%) ⬆️
integration-tests-20.x 78.74% <94.02%> (+0.04%) ⬆️
unit-tests-16.x 91.14% <100.00%> (+<0.01%) ⬆️
unit-tests-18.x 91.05% <97.01%> (+0.01%) ⬆️
unit-tests-20.x 91.05% <97.01%> (+0.01%) ⬆️
versioned-tests-16.x 75.09% <100.00%> (+<0.01%) ⬆️
versioned-tests-18.x 75.11% <100.00%> (+<0.01%) ⬆️
versioned-tests-20.x 75.12% <100.00%> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@jsumners-nr jsumners-nr merged commit 4378173 into newrelic:main Feb 16, 2024
25 checks passed
@jsumners-nr jsumners-nr deleted the fix-spec-docs branch February 16, 2024 15:04
jsumners-nr added a commit to jsumners-nr/node-newrelic that referenced this pull request Feb 16, 2024

Verified

This commit was signed with the committer’s verified signature.
jsumners-nr James Sumners
jsumners-nr added a commit to jsumners-nr/node-newrelic that referenced this pull request Feb 16, 2024

Verified

This commit was signed with the committer’s verified signature.
jsumners-nr James Sumners
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

None yet

2 participants