diff --git a/.github/issue_template.md b/.github/issue_template.md
new file mode 100644
index 000000000..86a82eaee
--- /dev/null
+++ b/.github/issue_template.md
@@ -0,0 +1,31 @@
+### My reason:
+
+<!-- 
+	a brief explanation of the issue, suggestion, feature
+-->
+
+### Steps to reproduce:
+
+<!-- 
+	(if it applies)
+	how can I do in order to reproduce it? environment? configuration?
+-->
+	
+### Additional information:
+
+<!--
+	provide the following information would be helpful
+-->
+	
+ - `$ set DEBUG=express:* verdaccio` enable extreme verdaccio debug mode
+ - `$ npm --verbose` prints:
+ - `$ npm config get registry` prints:
+ - Verdaccio terminal output
+ - Windows, OS X/macOS, or Linux?:
+ - Verdaccio configuration file, eg: `cat ~/.config/verdaccio/config.yaml`
+ - Container:
+   - [ ] I use local environment
+   - [ ] I develop / deploy using Docker.
+   - [ ] I deploy to a PaaS.
+
+### Additional verbose log:
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 000000000..4b2769924
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,8 @@
+# Contributing to Verdaccio
+
+## Before submit a new issue
+
+* Check if there's a simple solution in the wiki.
+* Search for similar issues.
+* [A quick look on Stackoverflow.](http://stackoverflow.com/questions/tagged/sinopia)
+* [Check if there is a legacy sinopia plugin for the feature that you need](https://www.npmjs.com/search?q=sinopia)
\ No newline at end of file