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.md | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 CONTRIBUTING.md (limited to 'CONTRIBUTING.md') diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..93c8bc9d --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,104 @@ +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 +[Developer Getting Started][gs] 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][gr] when you consider a patch set is ready. + +Please make sure there is at least one `+1` or `+2` from others before +submitting a patch set. + +Note: only members in `ldap/opnfv-gerrit-qtip-submitters` have permission +to submit. The current members are listed in [INFO][if]. + +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][jr]. The usage of different +[Issue Types][it] 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][or] 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 [OpenStack Style Guidelines][os] 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][rp] 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. + +[gs]: https://wiki.opnfv.org/display/DEV/Developer+Getting+Started +[gr]: https://gerrit.opnfv.org/gerrit/#/q/project:+qtip +[jr]: https://jira.opnfv.org/browse/QTIP +[or]: https://wiki.opnfv.org/display/SWREL +[it]: https://jira.opnfv.org/secure/ShowConstantsHelp.jspa?decorator=popup#IssueTypes +[os]: http://docs.openstack.org/developer/hacking/ +[if]: https://git.opnfv.org/cgit/qtip/tree/INFO +[rp]: http://www.sphinx-doc.org/en/stable/rest.html -- cgit 1.2.3-korg