Feature request: Update version of citation files with use_version

[roaldarbol]

use_version is super convenient for updating the the version in both DESCRIPTION and NEWS.md, however, one still has to manually edit the inst/CITATION (and CITATION.cff) file(s). It would be great it use_version could check whether such file(s) were present, and if they are, update the version within them.

[jennybc]

I just did a GitHub search for inst/CITATION files and the diversity of what I'm seeing in these files suggests this is not really amenable to automation.

If your own practices are consistent enough that you think this could be automated for your packages, it sounds like a good fit for a custom release bullet:

https://usethis.r-lib.org/reference/use_release_issue.html

If you want to consistently add extra bullets for every release, you can include your own custom bullets by providing an (unexported) release_bullets() function that returns a character vector. (For historical reasons, release_questions() is also supported).

[roaldarbol]

Is there any more documentation of the function? It sounds like it's just an issue that's generated, not an action that updates files - am I understanding that wrong?

It can definitely be automated, cffr does it; maybe it could be a parameter that defaults to FALSE?

[jennybc]

There's not a lot of documentation around the custom release bullets and, yes, it's a reminder to update something, not an automation of it. The best way to see examples of it would be to do a GitHub search of CRAN packages for release_bullets in the R directory.

I'm guessing that cffr can assume certain practices in the CITATION file, which then makes those files predictable and more favorable for automatic editing.