refactor: document() with latest roxygen2

[maelle]

Many changes due to @krlmlr's r-lib/roxygen2#1563
Merging this will allow for a cleaner diff next time we have to use document() 😁

[aviator-app]

Current Aviator status

Aviator will automatically update this comment as the status of the PR changes.
Comment /aviator refresh to force Aviator to re-examine your PR (or learn about other /aviator commands).

This PR was closed without merging. If you still want to merge this PR, re-open it.

---

See the real-time status of this PR on the Aviator webapp.

Use the Aviator Chrome Extension to see the status of your PR within GitHub.

[aviator-app]

This pull request failed to merge: PR cannot be automatically rebased, please rebase manually to continue. Remove the blocked label to re-queue.

Additional debug info: Failed to rebase this PR onto the latest changes from the base branch. You will probably need to rebase this PR manually and resolve conflicts).

[krlmlr]

Can you please use the GitHub version of roxygen2? It's better regarding the order of see-also-s.

[aviator-app]

This pull request failed to merge: PR cannot be automatically rebased, please rebase manually to continue. Remove the blocked label to re-queue.

Additional debug info: Failed to rebase this PR onto the latest changes from the base branch. You will probably need to rebase this PR manually and resolve conflicts).

[aviator-app]

This pull request can't be queued because it's currently a draft.

[maelle]

nothing changed in the end!