From 600ce47e6e1846f8523ddb0eafabdd2300a71839 Mon Sep 17 00:00:00 2001 From: Yujun Zhang Date: Tue, 13 Dec 2016 19:50:30 +0800 Subject: Convert contributing guide to markdown to get it embedded in wiki Change-Id: I969f97fea0bf9daca8816eefcf94fb7978bd51d9 Signed-off-by: Yujun Zhang --- CONTRIBUTING.rst | 114 ------------------------------------------------------- 1 file changed, 114 deletions(-) delete mode 100644 CONTRIBUTING.rst (limited to 'CONTRIBUTING.rst') diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst deleted file mode 100644 index d10f1393..00000000 --- a/CONTRIBUTING.rst +++ /dev/null @@ -1,114 +0,0 @@ -#################### -Contributing to QTIP -#################### - -First of all, thanks for taking your time to contribute. - -QTIP is a project in OPNFV. If you are new to OPNFV, you may read -:title:`Developer Getting Started`_ first. - -*********** -Peer Review -*********** - -Peer review is the most important communication channel between developers. -Every subtle change to the code or document **MUST** be reviewed before -submission. - -Add group ``qtip-reviewers`` in `gerrit`_ when you consider a patch set is ready. - -Please make sure there is at least one ``+1`` or ``+2`` from others before -submitting[#f1] a patch set. - -Active Reviewers -================ - -Current list of active reviewers in gerrit group ``qtip-reviewers`` - -* Serena Feng -* Taseer Ahmed -* Yujun Zhang -* Zhifeng Jiang -* Zhihui Wu - -By becoming an active reviewer, you agree to allow others to invite you as -reviewers in QTIP project freely. Any one in OPNFV community can apply to join -QTIP reviewers group or leave by submitting a patch on this document. - -**************** -Tasks and Issues -**************** - -Tasks and issues are management in `JIRA`_. The usage of different -:title:`Issue Types`_ in QTIP are as following: - -* ``Task``: it must be achievable in **one sprint**, otherwise it needs to be split. -* ``Sub-Task``: it must be resolvable by **one developer** within **one sprint**, -otherwise it need to be split. - -``Bug``, ``New Feature``, ``Improvement``, ``Story`` and ``Epic`` are not -restricted by time frame. But it is recommended to to define the scope clearly -and break down into manageable tasks. - -***************** -Development Cycle -***************** - -QTIP follows the cycle of `OPNFV Releases`_ which is approximately one release -every half year. - -The tasks are organized by sprints, three weeks for each. - -The target and content of each sprint is discussed in weekly meeting. - -************ -Coding Style -************ - -QTIP follows :title:`OpenStack Style Guidelines`_ for source code and commit message. - -Specially, it is recommended to link each patch set with a JIRA issue. Put - - JIRA: QTIP-n - -in commit message to create an automatic link. - -************* -Documentation -************* - -The documents are built automatically by sphinx from reStructuredText (reST). -Please read `reStructuredText Primer`_ if you are not familiar with it. - -A cheat sheet for headings are as following - -* # with overline, for parts -* * with overline, for chapters -* =, for sections -* -, for subsections -* ^, for subsubsections -* ", for paragraphs - -************************ -Frequent Asked Questions -************************ - -Q: May I work on task which have already been assigned to others? -A: Yes. But please make sure you have contacted the original assignee to avoid -overlapping. - -.. rubric:: Footnotes - -.. [#f1] only members in ``ldap/opnfv-gerrit-qtip-submitters`` have permission -to submit. The current members are listed in `INFO`_. - -.. rubric:: Reference - -.. _Developer Getting Started: https://wiki.opnfv.org/display/DEV/Developer+Getting+Started -.. _gerrit: https://gerrit.opnfv.org/gerrit/#/q/project:+qtip -.. _JIRA: https://jira.opnfv.org/browse/QTIP -.. _OPNFV Releases: https://wiki.opnfv.org/display/SWREL -.. _Issue Types: https://jira.opnfv.org/secure/ShowConstantsHelp.jspa?decorator=popup#IssueTypes -.. _OpenStack Style Guidelines: http://docs.openstack.org/developer/hacking/ -.. _INFO: https://git.opnfv.org/cgit/qtip/tree/INFO -.. _reStructuredText Primer: http://www.sphinx-doc.org/en/stable/rest.html -- cgit 1.2.3-korg