-
Notifications
You must be signed in to change notification settings - Fork 4
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
Remove attempt to detect fieldnames
for functions which lead to error
#113
Conversation
OK new error These are docstrings in the checked modules (configured with the modules keyword)
that are not included in canonical @docs or @autodocs blocks.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/utilities.jl#L166' status: 404.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/epi-models.jl#L106' status: 404.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/utilities.jl#L229' status: 404.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/utilities.jl#L210' status: 404.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/utilities.jl#L132' status: 404.
Error: linkcheck 'https://github.com/CDCgov/Rt-without-renewal/tree/a18526289735739427a468c5b3d6c162aa0235a9//src/utilities.jl#L194' status: 404.
Populate: populating indices.
ERROR: LoadError: `makedocs` encountered an error [:linkcheck] -- terminating build before rendering. |
These link errors point at where we've manually included docstrings with the proposed template; they were warnings in local build upgraded to full errors in CI |
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## main #113 +/- ##
=======================================
Coverage 97.74% 97.74%
=======================================
Files 6 6
Lines 133 133
=======================================
Hits 130 130
Misses 3 3 ☔ View full report in Codecov by Sentry. |
This passes and has fixed the main error, but I recommend if merged an issue on why the link checking was erroring. |
This looks to me to be because we aren't including functions in the internal or public API blocks at all at the moment (because they were erroring due to lack of docs). |
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.
LGTM
This aims to fix #108 .
The problem appears to be that we were setting a document
@template
for function, methods and macros which included fieldnames. Those objects don't have fieldnames, so this was chucking an error (this really should be a warning IMO...).