Skip to content

Automatically check repositories health and quality and build reports that help us understand the current state of Sauce Labs repositories

License

Notifications You must be signed in to change notification settings

opensourcediversity/check-my-repo

 
 

Repository files navigation

(Ͼ˳Ͽ)...check-my-repo!!!

check-my-rpo-site.mov

Aiming to help Open Source Software OSS maintainers we, at the Sauce Labs Open Source Program Office, created Check-My-Repo. An automated tool built upon Repolinter, that verifies if the main necessary parameters to comply with open source best practices: from Readme to License, are present in the organizations or users repositories. By automating this verification open source projects maintenance is more effective and effortless, and can help you and your organization to have compliant software projects easier to service, test, upgrade, and maintain. Built with Node.js, Repolinter and Vue.js, it is designed to run locally and automated, displaying results on your organization’s or user’s GitHub Page.

Meant to be as easy as possible to enable right away usage, all you need to do is: fork it, and enable Pages choosing gh-pages as your GitHub pages repository. That easy 😊.

How to adopt it into my organization?

  1. Fork it
  2. Enable Actions on Settings/ Actions Permissions
  3. Enable Pages on Settings/ Pages by choosing gh-pages as your GitHub pages repository
check-my-repo-how-to.mov

Using GitHub Actions and default environment variables, it will automatically get our user/ organization public information.

Please note that, as Actions are planned to run once a day on cron: '0 0 * * *' time, or when a push is made to the main branch, you need to wait until your organization/ user information is updated in the page.

It is designed to be as neutral as possible and comply with A11y accessibility guidelines. But, of course, you can modify all you want, it is open sourced under MIT license. Check How to Configure file to know how to do it.

Trouble-shooting

Even if you enable GitHub Actions, you may need to enable it in 2 other places on the Actions tab. After clicking on the enable button, go back to Settings / Pages and you will see a note saying your page is published.

touble-shooting-check-my-repo.mov

Command Line Step By Step & Running It Locally

  1. Fork this project

  2. Navigate in your terminal into the director you want to clone the repository, for example:

cd Documents

  1. Clone your fork (remember to change "YOUR ORGANIZATION")
git clone https://github.com/<YOUR ORGANIZATION>/check-my-repo.git

  1. Open the cloned directory
cd check-my-repo

  1. Open the repository on your favorite code editor. If you are using VSC you can use .code to open your code editor

  2. Install dependencies

npm install
  1. To run it locally, run the script:
node src/index.js

It enables you to verify all of your organization’s or user’s public repositories. You need to do this process at least once, as this generates a frontend.json file on the frontend/public folder, which will be used to display the information in Browser.

  1. Now let’s install your frontend application:
cd frontend
  1. Install frontend dependencies
npm install
  1. Run server locally
npm run serve
  1. Open link provided in terminal
Cmd + click

That’s it!

Contributing

See CONTRIBUTING.md for details.

Want a fast, setup dev environment? Open in Gitpod.

Hacktoberfest

Here for Hacktoberfest?. Check out Our Hacktoberfest Issues, or visit https://opensource.saucelabs.com/hacktoberfest/ to see all our Hacktoberfest projects!

About

Automatically check repositories health and quality and build reports that help us understand the current state of Sauce Labs repositories

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Vue 58.5%
  • JavaScript 39.1%
  • HTML 1.6%
  • Shell 0.8%