DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
  1. DZone
  2. Testing, Deployment, and Maintenance
  3. Deployment
  4. GitHub Templates

GitHub Templates

For all you new comers to web dev, or those who are looking for a quick refresher, read on to learn how GitHub templates can assist in your product documentation.

Venkatraman Ramamoorthy user avatar by
Venkatraman Ramamoorthy
·
May. 11, 17 · Tutorial
Like (7)
Save
Tweet
Share
6.53K Views

Join the DZone community and get the full member experience.

Join For Free

In today’s web development world, Git is a powerful SCM (Source Control Management). GitHub is a web-based Git SCM Provider. These guys play an important role in all open-sourced projects, where you can see 95% of such projects.

GitHub's importance in open-source projects is made evident by the soaring number of contributors. It's important to note that internet giants like Facebook, Google and Microsoft have created their own organizational pages and published their projects. Let's get to the point. In this post, we are going to discuss GitHub Templates.

Why Do We Need Templates?

  1. GitHub introduces templates for their web forms (issues, pull requests, etc.), which can configure inputs to be pre-filled with data which will help maintainers to set up a questionnaire and help contributors to do their part fast.
  2. It’s hard and tough to solve a problem when important details about a contributor's project are missing in the pull request or in the issues folder. Both are web forms in GitHub where you can submit without an accompanying description, like below, which causes these contributions to become meaningless.

Bad Request — Pull Request with Empty Description

Let’s talk about the above Pull Request where the title and commit message says Header Changes. It’s hard to fathom this code change by Reviewers. It may be a great contribution, but this kind of code will give only a rough idea of which issues are most important. It may introduce new defects because they are not very clear about the current and new behavior.

How About With Descriptions? Let's Have a look!

Pull Request with Description

Above is a good and descriptive pull request which can be easily understood. Our goal should be to value the contributions and issue requests which will be reviewed and merge faster than usual.

So Github Templates Solve This Problem?

Yes. GitHub Templates help to configure your templates which will help to configure questionnaires. Now maintainers can add templates, but make sure your template file names are composed following proper naming conventions. Below is an example for an ISSUE Template.

GitHub Templates

It's always good to categorize your request as a pull request or an issue. Please read the Things you should know section for few more templates in various use cases provided by GitHub.

Things You Should Know

  1. Add PULL_REQUEST_TEMPLATE.md for Pull Request Template.
  2. Add Issue_TEMPLATE.md for Issue Template.
  3. Add CONTRIBUTING.md for Contribution Guidelines.
  4. Add CODE_OF_CONDUCT.md for Setting Coding Standard Guidelines.
  5. Add LICENSE or LICENSE.txt for License.
  6. You can keep it in the root directory or move all of them under the directory called .github.
  7. A file extension is optional, but Markdown files (.md) are supported.

You Are Done. Checkout How it Looks!

Cool, isn’t it?!

Happy coding, stay tuned for the next one!

Template GitHub Git

Published at DZone with permission of Venkatraman Ramamoorthy. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Enabling DB Migrations Using Kubernetes Init
  • Learning by Doing: An HTTP API With Rust
  • 9 Ways You Can Improve Security Posture
  • The Real Democratization of AI, and Why It Has to Be Closely Monitored

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: