Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Closed
tlylt opened this issue Apr 29, 2022 · 3 comments · Fixed by #1858
Closed

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

tlylt opened this issue Apr 29, 2022 · 3 comments · Fixed by #1858
Labels

Comments

@tlylt
Copy link
Contributor

tlylt commented Apr 29, 2022

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
Copy link
Contributor Author

tlylt commented Jan 11, 2023

Hi @yhtMinceraft1010X, any thoughts on the above?

@yhtMinceraft1010X
Copy link
Contributor

Hi @yhtMinceraft1010X, any thoughts on the above?

Thanks for your interest in improving RepoSense. Feel free to open a PR for this.

@tlylt
Copy link
Contributor Author

tlylt commented Jan 14, 2023

Hi @yhtMinceraft1010X, any thoughts on the above?

Thanks for your interest in improving RepoSense. Feel free to open a PR for this.

Thanks, will open a PR to add this to the docs for visibility of the GitHub action available:)

dcshzj pushed a commit that referenced this issue Jan 22, 2023
Generating RepoSense reports via GitHub Actions requires forking of the
template publish-RepoSense repo. It also only supports publishing with
GitHub Pages.

This process is more complicated than utilizing published actions on the
marketplace. It also requires direct edits to the script files for more
customization.

Let's document an available alternative via a community-published action
for interested users to explore.

The published action can be used in the same directory as the user's
project and support customization via action arguments. It also supports
surge.sh as an alternative publishing platform.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: Closed/Completed
Development

Successfully merging a pull request may close this issue.

3 participants