dot-github
dot-github copied to clipboard
Template repo with common GH related files
dot-github
Just another generic GitHub repository template for all :smile:
Overview
In June of 2019 GitHub announced repository templates, which allow for people/organizations to use template repositories as a boilerplate to quickly generate new GitHub repositories. I wanted to put together a (mostly) language agnostic repository template for my own projects, and hope that others may benefit from this work.
Features
This repository template includes;
- An easily customizable boilerplate README.md file that follows this one
- A Code of Conduct
- Adapted from the Contributor Covenant
- An in-depth Contribution guide
- Support for all-contributors
- Documentation for how people can get support
- Templates for;
- Bug Reports
- Feature Requests
- Pull Requests
- Pre-configured editorconfig, gitattributes, and gitingore files
- Suggested Visual Studio Code extensions for faster IDE setup
Usage
The steps to use this template repository in your own projects are;
- Create a new repository using this template
- Rename this
README.md
file to something else, such asTEMPLATE_README.md
- Rename the provided
BOILERPLATE_README.md
toREADME.md
- Replace instances of
YOUR_*
in your newREADME.md
to customize the shields, social links, etc to yourself and your project-
YOUR_NAME
- Your name (ie, John Doe) -
YOUR_GITHUB_NAME
- Your GitHub user name (ie,github.com/<user_name>
) -
YOUR_GITHUB_REPO
- Your GitHub repository name (ie,github.com/<user_name>/<repository_name>
) -
YOUR_TWITTER_NAME
- Your Twitter user name (ie,twitter.com/<your_name>
) -
YOUR_PATREON_NAME
- Your Patreon name (ie,patreon.com/<your_name>
) -
YOUR_DISCORD_SERVER_ID
- Your Discord server id (follow the steps in this video to set up widget permissions on your server and get your server id) -
YOUR_DISCORD_INVITE_LINK
- Invite link to your Discord server steps here
-
- Customize the rest of the repository to your hearts content
- Start creating!
Releases
All releases can be found on the Releases page for this project.
Contributing
Contributions are vital to the health and longevity of open source projects, and they are always welcome here! Please check out the Contributing guide as well as the setup guide to get started.
Community
Feel free to join our community!
Contributors
Thanks goes to these wonderful people (emoji key):
Rob Davis 📖 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!
License
This project is provided under the MIT License © 2020 Rob Davis.