Update documentation, added Issue Report guidance

Author: lushang

README.md

@@ -1,7 +1,7 @@
 # Sublime IDE for Salesforce
-This plugin supports [Sublime Text 3](http://www.sublimetext.com/3) for windows and OSX, not tested for Linux.
+This plugin supports [Sublime Text 3](http://www.sublimetext.com/3) for windows and OSX, has not enough testing for Linux yet.
 
-All of my motivation on this plugin come from your star, if you think this plugin is helpful in your daily work, please **star** this plugin.
+All of our motivation on this plugin come from your star, if you think this plugin is helpful in your daily work, please **star** this plugin.
 
 # Installation
 
@@ -14,7 +14,7 @@ Or, You can follow the step-by-step [instruction](https://meighanrockssf.wordpre
 # Project Configuration
 After you have installed this plugin successfully, you can follow <a href="/docs/project.md" target="_blank">Project Configuration</a> to configure your own project.
 
-If you don't want to keep your user credential information in the plugin , you just need to do it as below format, plugin will lanuch the browser to start OAuth2 Login process,
+If you don't want to keep your user credential information in the plugin , you just need to do it as below format, plugin will launch the browser to start OAuth2 Login process,
 ```javascript
 "projects": {
   "pro-sublime": {
@@ -64,6 +64,12 @@ If you don't want to keep your user credential information in the plugin , you j
   > - [Salesforce oAuth2](https://github.com/neworganizing/salesforce-oauth2)
   > - [SalesforceXyTools](https://github.com/exiahuang/SalesforceXyTools)
 
+# Feedback & Contribution
+Feel free to open issues, but you should refer to the <a href="/docs/issue.md" target="_blank">Raise Issue</a> before
+reporting any bug.
+
+well welcome to any contribution, open an issue for discussion before draft you code.
+
 # Q&A
 + ``Refresh Package`` vs ``Update Project``
     * ``Refresh Package`` can update the project by the ``package.xml`` in the project folder or ``project/src`` folder
@@ -78,7 +84,7 @@ If you don't want to keep your user credential information in the plugin , you j
     * ``Deploy to Server`` is achieved by ``Metadata API`` tech, which is usually used to develop none-apex in sandbox, deploy any components into different org or production
 
 + What's the usage of ``Update Project Pattern`` command?
-    * Everytime when you udpate the ``file_exclude_patterns`` or ``folder_exclude_patterns``, you must execute ``Update Project Pattern`` command to ensure it is working.
+    * Everytime when you update the ``file_exclude_patterns`` or ``folder_exclude_patterns``, you must execute ``Update Project Pattern`` command to ensure it is working.
     * Everytime when the default project doesn't appeared in the sidebar panel, you an use this command to show the default project.
 
 + If you failed to deploy package after release 3.3.7

docs/issue.md

@@ -0,0 +1,30 @@
+# Raise Issue
+
+Create an [Issue][1] for following situations:
+- Find a bug
+- Have a good idea about any enhancement/new feature
+
+### Report a Bug ###
+
+For better investigation, you should include following message:
+
+1. Title: a concise summary about the bug
+2. Description about the bug
+    - Details with text description, provide screenshot if necessary.
+    - Steps to recur the bug.
+    - Any workaround you have tried.
+3. Context information
+    - Operation System and version. e.g *Windows 10, version 1903*
+    - Sublime Test 3 version. e.g *Version 3.2.2 Build 3211*
+    - Your HaoIDE version. e.g *Build 3.6.0*
+    - Sublime Text 3 console log. You can press `Ctrl+~` to open the console panel.
+    - Your user settings if necessary.
+    - Any other necessary information.
+
+### Propose an Enhancement or a New Feature
+
+Just open an issue to discuss it! 
+
+If you want to contribute, also open an issue before draft the code!
+
+[1]: https://github.com/xjsender/haoide/issues