diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000000000000000000000000000000000000..e4af90fdd10a97a90a00b5ac48a027d383dd37dd
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,29 @@
+---
+name: Bug report
+about: Problems or errors you found while using zero-el
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**What is the problem and how to reproduce it?**
+
+Please describe how you press keys, what you expect to see, and what you did
+see.
+
+**Tell me about your user environment, please fill in versions**
+
+- OS (e.g. Debian 9, Ubuntu 19.04): 
+
+- emacs: 
+  M-x emacs-version
+
+- zero-input: 
+  C-h v zero-input-version
+
+- zero-pinyin-service: 
+  apt-cache policy zero-pinyin-service
+
+- zero-panel: 
+  apt-cache policy zero-panel
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000000000000000000000000000000000000..54b607edca768e5decc3f2aacc4ebd88c8451bc7
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Describe the feature you need.**
+It is best your feature is concrete and is described in detail.
+
+
+
+**Is this feature available in other input methods? If so, please name the other input methods.**
+
+
+
+**If you have a patch available, please specify the patch/branch URL.**
diff --git a/README b/README
index fe80efed202a1160d5b58669c8ad93b215d7a960..6e2eaa6d9a11d4d08d7c455300443fb2dabdcff1 100644
--- a/README
+++ b/README
@@ -4,13 +4,16 @@ Time-stamp: <2020-02-20>
 
 * zero-el
 
+[[http://www.melpa.org/#/zero-input][file:http://www.melpa.org/packages/zero-input-badge.svg]]
+[[https://stable.melpa.org/#/zero-input][file:https://stable.melpa.org/packages/zero-input-badge.svg]]
+
 zero-el provides zero-input-pinyin, an Emacs pinyin input method for Chinese
 and zero-input-framework, which is an emacs Chinese input method framework.
 
 * An introduction to zero-el, including how to install and config zero-el.
 https://blog.emacsos.com/zero-el.html
 
-For normal configurable variables, see
+For user configurable variables, see
 M-x customize-group zero-input
 M-x customize-group zero-input-pinyin
 
@@ -27,7 +30,7 @@ M-x customize-group zero-input-pinyin
   key.
 
   Some notes on pinyin string,
-  - There is no ü on US keyboard, type v instead. For example lve 略.
+  - There is no ü on US keyboard, type v instead. For example lv 绿.
   - Use ' to separate pinyin substring like xi'an 西安
 
 * Zero Framework features
@@ -40,6 +43,11 @@ M-x customize-group zero-input-pinyin
   "3." will insert "3。", just continue type 6, it will be converted to
   "3.6". Same thing for "H。265" -> "H.265".
 
+* Bug Report and Feature Request
+Please report bugs at [[https://github.com/sylecn/zero-el/issues][github issues]]. Note that development (and melpa pkg)
+still happens on gitlab repo. The github repo is an official mirror to make
+reporting issue easier.
+
 * Changelog
 - see ./ChangeLog
 - The change log include change log from all sub projects.
diff --git a/operational b/operational
index 710b01b9cbeaded19ef51dfa4b4f070f4c741515..0ecb3453a4ca0c50daea415a2bb510cb075de8ef 100644
--- a/operational
+++ b/operational
@@ -114,6 +114,13 @@ cd ~/lisp/elisp/zero/
 * later                                                               :entry:
 * current                                                             :entry:
 ** 
+** 2020-02-20 add github issue system support.
+- create issue templates online. then merge into master.
+  git remote add github git@github.com:sylecn/zero-el.git
+  git fetch github sylecn-patch-1
+  gco github/sylecn-patch-1 .github/
+- update README, add bug report doc.
+- 
 ** 2019-10-23 checkdoc and package-lint can't ignore some non-issues.
 I can't run them in git pre-commit hook.
 * done                                                                :entry:
diff --git a/zero-input.el b/zero-input.el
index 1d7759009f6d57ed0dad5fe79ebbc13dcf0f1dbf..5b8b32aa9ca1169d81f99164051c22db1367833f 100644
--- a/zero-input.el
+++ b/zero-input.el
@@ -18,10 +18,6 @@
 
 ;;; Commentary:
 
-;; zero-input.el is auto-generated from multiple other files.  see
-;; zero-input.el.in and build.py for details.  It's created because
-;; package-lint doesn't support multi-file package yet (issue #111).
-;;
 ;; zero-input is a Chinese input method framework for Emacs, implemented as an
 ;; Emacs minor mode.
 ;;
@@ -29,11 +25,13 @@
 ;; ~/.emacs file:
 ;;
 ;;   (require 'zero-input)
-;;   (zero-input-set-default-im 'pinyin)
+;;   (zero-input-set-default-im "pinyin")
 ;;   ;; Now you may bind a key to zero-input-mode to make it easy to
 ;;   ;; switch on/off the input method.
 ;;   (global-set-key (kbd "<f5>") 'zero-input-mode)
 ;;
+;; Now in any emacs buffer, you may press F5 and start typing pinyin string.
+;;
 ;; zero-input supports Chinese punctuation mapping.  There are three modes,
 ;; none, basic, and full.  The default is basic mode, which only map most
 ;; essential punctuations.  You can cycle zero-punctuation-level in current
@@ -47,6 +45,13 @@
 ;;
 ;;   (setq-default zero-input-full-width-p t)
 ;;
+;; For other features, you may check README file at
+;; https://gitlab.emacsos.com/sylecn/zero-el/
+;;
+;; zero-input.el is auto-generated from multiple other files.  see
+;; zero-input.el.in and build.py for details.  It's created because
+;; package-lint doesn't support multi-file package yet. See issue #111 at
+;; https://github.com/purcell/package-lint/issues/111
 
 ;;; Code:
 
diff --git a/zero-input.el.in b/zero-input.el.in
index 9d0447f650451134856f20b4347b7626b2285e47..b1681da9db5bf1b31a67681049b87ab01cd6072c 100644
--- a/zero-input.el.in
+++ b/zero-input.el.in
@@ -18,10 +18,6 @@
 
 ;;; Commentary:
 
-;; zero-input.el is auto-generated from multiple other files.  see
-;; zero-input.el.in and build.py for details.  It's created because
-;; package-lint doesn't support multi-file package yet (issue #111).
-;;
 ;; zero-input is a Chinese input method framework for Emacs, implemented as an
 ;; Emacs minor mode.
 ;;
@@ -29,11 +25,13 @@
 ;; ~/.emacs file:
 ;;
 ;;   (require 'zero-input)
-;;   (zero-input-set-default-im 'pinyin)
+;;   (zero-input-set-default-im "pinyin")
 ;;   ;; Now you may bind a key to zero-input-mode to make it easy to
 ;;   ;; switch on/off the input method.
 ;;   (global-set-key (kbd "<f5>") 'zero-input-mode)
 ;;
+;; Now in any emacs buffer, you may press F5 and start typing pinyin string.
+;;
 ;; zero-input supports Chinese punctuation mapping.  There are three modes,
 ;; none, basic, and full.  The default is basic mode, which only map most
 ;; essential punctuations.  You can cycle zero-punctuation-level in current
@@ -47,6 +45,13 @@
 ;;
 ;;   (setq-default zero-input-full-width-p t)
 ;;
+;; For other features, you may check README file at
+;; https://gitlab.emacsos.com/sylecn/zero-el/
+;;
+;; zero-input.el is auto-generated from multiple other files.  see
+;; zero-input.el.in and build.py for details.  It's created because
+;; package-lint doesn't support multi-file package yet. See issue #111 at
+;; https://github.com/purcell/package-lint/issues/111
 
 ;;; Code: