Skip to content

nshift/github-guidelines

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 

Repository files navigation

Github Guidelines

We will do all that we can to keep the productivity of ourselves, and others, as high as possible -- Uncle Bob

These guidelines are based on Building a strong community Github documentation and intend to promote a better collaboration.

Table of Contents

Issue & Pull Request Template

Issue and pull request templates should drive reporters to give all the necessary information to help reviewers.

Import the pull request template and issue template into .github folder in your repository root directory.

Multiple Issue Templates Over Single Issue Template

Multiple issue templates are prefered over single issue templates in order to specify required information for each type of issue.

Import the following issue templates into .github/ISSUE_TEMPLATE/ folder in your repository root directory:

Issue & Pull Request Expectation

Issue and pull request templates should contains title (h2) and description using html comment.

Preferred:

## Description
<!-- A clear and concise description of what the bug is. -->

## How to reproduce it
<!-- Steps to reproduce the behavior. -->

...

Not Preferred:

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

...

Promoting A High Contribution Quality

Templates should promote a high contribution quality by referring contributing guidelines.

Preferred:

> Please fill out this template when filing an issue. It is based on [Excelsior Family Github guidelines](https://github.com/ExcelsiorFamily/github-guidelines).
>
> This template intends to describe a bug report. If you are describing a non existing feature, please use the [feature request template](https://github.com/ExcelsiorFamily/github-guidelines/issues/new?template=feature-request.md).

* [ ] I've read, understood, and done my best to follow the [CONTRIBUTING guidelines](/CONTRIBUTING.md).

## Description
<!-- A clear and concise description of what the bug is. -->

## How to reproduce it
<!-- Steps to reproduce the behavior. -->

...

Not Preferred:

## Description
<!-- A clear and concise description of what the bug is. -->

## How to reproduce it
<!-- Steps to reproduce the behavior. -->

...

Milestone

Label

CHANGELOG

CONTRIBUTING.md

Resources

About

✊ We will do all that we can to keep the productivity of ourselves, as high as possible.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages