docs: link to revdepcheck fn #2105
Conversation
plus minor tweaks
| #' artefacts | ||
| #' * Prompts user to run the checks with `revdepcheck::revdep_check()` | ||
| #' artefacts. | ||
| #' * Prompts the user to run the checks with [revdepcheck::revdep_check()]. |
There was a problem hiding this comment.
I can't link to a topic in a package that's not on CRAN, which revdepcheck is not.
There was a problem hiding this comment.
Why can't you link to it? Is there a CRAN rule forbidding this?
There was a problem hiding this comment.
Technically you should have a formal dependency on a package to link to its help topics:
https://cran.r-project.org/doc/manuals/r-devel/R-exts.html#Cross_002dreferences-1
Packages referred to by these ‘other forms’ should be declared in the DESCRIPTION file, in the ‘Depends’, ‘Imports’, ‘Suggests’ or ‘Enhances’ fields.
In the past, you can sort of get away with a link to something you don't depend on, sometimes. But I would not go so far for a package that is not even on CRAN.
Also CRAN is now making static HTML reference manuals, which has triggered a big wave of requests to re-release packages cleaning up various documentation loose ends. So if anything, this is all going to get even stricter.
plus minor tweaks