RepoSense icon indicating copy to clipboard operation
RepoSense copied to clipboard

Add/Document a GitHub Action to automate publishing of the report

Open tlylt opened this issue 2 years ago • 0 comments

What problem(s) did you run into that caused you to request additional documentation? What, if any, existing documentation relates to this proposal?

Hi RepoSense devs,

I was looking through the UG, especially the section on deploying RepoSense report via GitHub Actions here: https://reposense.org/ug/withGithubActions.html

I thought the need to fork a repository in order to set up a RepoSense report can be quite complicated and intimidating for a new user. I decided to play around with the existing scripts in publish-reposense and make an MVP - reposense-action to ease the process by eliminating the need to fork. So, just do:

  • Specify the config files in the configs folder of the target repo.
  • Create a reposense.yml with the following content in .github/workflows/:
name: Deploy RepoSense report

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - uses: tlylt/reposense-action@main
      with:
        token: ${{ secrets.GITHUB_TOKEN }}

Other options are available and documented in the readme. To address the problem of existing GitHub pages being used for other purposes, I provided an alternative deployment service option surge.

Opening this issue to see if there's any interest from RepoSense to adopt the action (into the organization) or document it in your UG as a utility tool out there. Otherwise, I am happy to continue working on it on my own as well (at least as long as I am interested in the project :))

tlylt avatar Apr 29 '22 17:04 tlylt