[TIMOB-20424] Support for Github pull request & issue templates
GitHub Issue | n/a |
---|---|
Type | Story |
Priority | Low |
Status | Closed |
Resolution | Done |
Resolution Date | 2016-08-04T02:45:06.000+0000 |
Affected Version/s | n/a |
Fix Version/s | Release 5.4.0 |
Components | Specification |
Labels | n/a |
Reporter | Hans Knöchel |
Assignee | Hans Knöchel |
Created | 2016-02-18T08:17:21.000+0000 |
Updated | 2016-08-04T02:45:06.000+0000 |
Description
Github recently published a new feature to create issue- and PR-templates for community contributions.
In our case, we would be able to inform the user about the coding guidelines for extending the SDK, the CLA link, the necessary docs etc. For issues, we could mention to create a JIRA ticket first, attach build logs and provide the environment.
The required files (
PULL_REQUEST_TEMPLATE
and ISSUE_TEMPLATE
) are placed inside a .github directory.
More information: https://github.com/blog/2111-issue-and-pull-request-templates
Changed to story since this is more of a task and there's nothing for QE to test.
The draft for pull requests can be found here: - [Pull-Request template](https://gist.github.com/hansemannn/4d1a3de809606599acf7) - [Issue template](https://gist.github.com/hansemannn/52dabbfc8c1b2b1745c8) [~fokkezb], feel free to add things to wish to mention. Also, if you have thoughts what we should use for the issue template, let me know!
We don't have Issues enabled for most repositories since we use JIRA. If we do have repositories with Issues enabled, we need to decide if we actually want that (or just forgot to disable). If we have a valid reason, then we can use the issue template. Left some issues on the gist: https://gist.github.com/hansemannn/52dabbfc8c1b2b1745c8#gistcomment-1711553 (hint: use https://giscus.co/)
Also left some comments on the PR template: https://gist.github.com/hansemannn/4d1a3de809606599acf7#gistcomment-1711563 Great stuff Hans!
Agree in all points. For now, we should only provide the PR template which could be used in all public repositories (starting with titanium_mobile and our most popular appcelerator_modules). PR for titanium_mobile will be up today.
Be sure to add it under a
.github
folder. Do we need.github/CONTRIBUTING.md
as well? It creates a nice [alert](https://help.github.com/articles/setting-guidelines-for-repository-contributors/).Well, if you have additional content to put into there, sure!
PR: https://github.com/appcelerator/titanium_mobile/pull/7787