Skip to content

Documentation check #267

Description

@hadley
  • Run roxygen2::roxygenise() and check no files changed
  • Check that pkgdown::build_reference_index() is ok
  • Spellcheck?
  • URL check?

Activity

  1. hadley commented on Mar 29, 2021

    @hadley
    MemberAuthor

    Look at what Shiny does.

  2. gaborcsardi commented on Dec 10, 2021

    @gaborcsardi
    Member

    Do you still want these as separate actions? Or as an example workflow that does all of them?

  3. hadley commented on Dec 10, 2021

    @hadley
    MemberAuthor

    Let's wait for @schloerke since this is something that Shiny already does.

    We should also think about compiling translation files .mo as part of this step.

  4. gaborcsardi commented on Oct 19, 2022

    @gaborcsardi
    Member

    Hadley, do you still want an action and/or workflow for these?

    TBH it does not seem practical to introduce new jobs for these.

    • Maybe the roxygen2::roxygenise() check could be part of the check-r-package action?
    • pkgdown we already "check" in the pkgdown action, which now also runs for PRs
    • Spellcheck could be also part of the check-r-package action, optionally.
    • We could turn on URL checks in R CMD check, or run the URL checks as part of the check-r-package action.
  5. hadley commented on Oct 19, 2022

    @hadley
    MemberAuthor

    Yeah, I think the best way to handle these would be to introduce additional features/functions in rcmdcheck, and then set those options for actions.

  6. gaborcsardi commented on Oct 20, 2022

    @gaborcsardi
    Member

    This is blocked by new features in rcmdcheck.

  7. AlexAxthelm commented on Jun 7, 2024

    @AlexAxthelm

    Our team has a pretty simple workflow that we call that has been handling our needs for this
    https://github.com/RMI-PACTA/actions/blob/main/.github/workflows/R-check-docs.yml

  8. hadley commented on Apr 30, 2026

    @hadley
    MemberAuthor
  9. AlexAxthelm commented on May 5, 2026

    @AlexAxthelm

    An issue that was preventing our team from chasing down a "docs check" more robustly is that GH Actions doesn't have a good "warning" level for checks (tracked at https://github.com/orgs/community/discussions/11592). The workflow our team would generally use is to make whatever code changes we would need to on branch and then rebuild docs at the end, just before opening for review. We've generally been able to use the "required" status checks to make this a non-blocking check.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    blockedBlocked by an issue elsewherefeaturea feature request or enhancement

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions