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

Remove attempt to detect fieldnames for functions which lead to error #113

Merged
merged 2 commits into from
Mar 5, 2024

Conversation

SamuelBrand1
Copy link
Collaborator

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...).

@SamuelBrand1 SamuelBrand1 requested a review from seabbs March 5, 2024 14:18
@SamuelBrand1 SamuelBrand1 linked an issue Mar 5, 2024 that may be closed by this pull request
@SamuelBrand1
Copy link
Collaborator Author

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.

@SamuelBrand1
Copy link
Collaborator Author

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-commenter
Copy link

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.74%. Comparing base (791d8e2) to head (15e27b5).

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.
📢 Have feedback on the report? Share it here.

@SamuelBrand1
Copy link
Collaborator Author

This passes and has fixed the main error, but I recommend if merged an issue on why the link checking was erroring.

@seabbs
Copy link
Collaborator

seabbs commented Mar 5, 2024

OK new error

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).

Copy link
Collaborator

@seabbs seabbs left a comment

Choose a reason for hiding this comment

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

LGTM

@seabbs seabbs merged commit bc87599 into main Mar 5, 2024
10 checks passed
@seabbs seabbs deleted the 108-documenter-broken-on-main branch March 5, 2024 17:32
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.

Documenter broken on main
3 participants