Auth0 Open Source Template
This repo contains sample files to be used in Auth0 open source software repositories. These files are guidelines that can be used in an Auth0 or any open source project to ensure that the project is described properly, the contribution process is clear, and additional tools like CI, coverage monitors, and quality checkers are configured properly.
Table of Contents
This repo can be cloned, modified, then re-purposed for new open source projects. It can also be used piecemeal to improve existing repos.
Copy README-sample.md to README.md
The core of open source repo quality is the
README.md file that's displayed on the repo's homepage in Github. The
README-sample.md included here was collaboratively created by Auth0's SDK engineering team and community engineering team based on samples of high-quality README files around the web.
Most sections within this file should be considered required, even if that section contains a link to a more relevant page. Certain sections will contain repo-specific information and should be modified as needed:
- Description (below the title)
- Getting Started
- Thank you
Other sections should be used as-is with minimal changes:
- Table of Contents
- Support + Feedback
- Vulnerability Reporting
- What is Auth0?
Modify templates in
The issue and PR templates contained in this repo are general guidelines for what to include. What is being asked for is entirely up to the repo maintainer but a template of some kind should be included.
README-sample.md for guidelines.
This file contains files that will be excluded from git. Modify as needed based on the technology being used.
Modify/remove platform-specific files
Additional template files have been included here for the specific technology that we work with. These should be considered as guidelines and not enforced in any way.
We appreciate feedback and contribution to this template! Before you get started, please see the following:
A big thank you to all of our sources of inspiration!
- First Contributions by @Roshanjossey
- First Timers Only
- Sane Github Labels
- Awesome README by @matiassingers
... and many more!
This repo is covered under The MIT License.