Skip to content

Commit

Permalink
[docs] Add PR template and clarify requirements to the PR description.
Browse files Browse the repository at this point in the history
  • Loading branch information
Roman Dzhabarov authored and rdzhabarov committed Aug 27, 2018
1 parent 05af31f commit 6d2d18d
Show file tree
Hide file tree
Showing 2 changed files with 50 additions and 0 deletions.
44 changes: 44 additions & 0 deletions PULL_REQUEST.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Title

The title of the PR should be short and expressive enough to reflect the proposed changes.
It should start with the name of the subsystem affected by the PR in the square braces.
For example:
* [quantization] Properly quantize ReLU
* [opencl] Define a type cl_host_size_t exactly matching the type size_t used on the host side
* [Type.h] Add comments for the ElemKinds

Ideally, the same format should be used in the commit message.

# Description

The description field should include a more verbose explanation of what this PR does.
If this PR causes a change in behavior it should document the behavior before and after.
If it fixes a bug, please, describe what the original issue is and how the change resolves it.

# Formatting

Please, run clang-format before submitting the PR.

# Testing

The testing section should include an explanation of what testing was done.
For example unit test, manual testing through stand-alone testing binaries like mnist, cifar10, etc.
Please use your best judgment or ask for guidance if you are unsure what kind of testing is required for a given change.
The riskier the change, the more comprehensive the testing should be.
If PR fixes an existing bug, make sure to present unit test which reveals the original problem.

# Documentation

Please, make sure to update existing docs if your change affects those.
Docs can be found under the glow/docs. Use your best judgment for creating new docs.

# Issues

If the PR fixes an existing issue, please add a line of the form:
* Fixes #Issue.

This way Github will make sure that underlying referenced issue will be automatically closed once PR is merged.

If the purpose of the PR to address issue partially, please, just tag the issue:
* #Issue.

6 changes: 6 additions & 0 deletions PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
*Description*:
*Testing*:
*Documentation*:
[Optional Fixes #issue]

Please see a detailed explanation of how to fill out the fields in the relevant sections in PULL_REQUEST.md.

0 comments on commit 6d2d18d

Please sign in to comment.