Commit Graph

23 Commits

Author SHA1 Message Date
zdover23
8624f6f93d
Merge pull request #37587 from anthonyeleven/yet-more-doc-polishing
doc: clarity, detail, modernization, capitalization

Reviewed-by: Zac Dover <zac.dover@gmail.com>
2020-10-15 02:48:25 +10:00
Anthony D'Atri
32375cb789 doc: misc clarity and capitalization
Signed-off-by: Anthony D'Atri <anthony.datri@gmail.com>
2020-10-12 13:41:46 -07:00
Kefu Chai
38ced60485 SubmittingPatches: use "doc" prefix in title of doc-only commits
Signed-off-by: Kefu Chai <kchai@redhat.com>
2020-10-07 17:43:57 +08:00
Varsha Rao
5b34a9bbf5 doc/SubmittingPatches: Fix 'Fixes line' hyperlink
Signed-off-by: Varsha Rao <varao@redhat.com>
2020-04-13 19:29:35 +05:30
Nathan Cutler
ec6af09384 doc: split up SubmittingPatches.rst
Split the existing SubmittingPatches.rst into three files:

* SubmittingPatches.rst (general guidelines, for GitHub/master branch)
* SubmittingPatches-kernel.rst (for kernel patches)
* SubmittingPatches-backports.rst (for backports)

Fixes: http://tracker.ceph.com/issues/20953
Signed-off-by: Nathan Cutler <ncutler@suse.com>
2019-10-17 19:32:03 +02:00
Patrick Donnelly
e72f590477
doc: indicate imperative mood for commit titles
This is convention in the kernel and Ceph but is not clearly documented.

Signed-off-by: Patrick Donnelly <pdonnell@redhat.com>
2019-08-06 11:18:21 -07:00
James McClune
d78863e049 SubmittingPatches: added inline markup to important references
Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2019-01-15 22:42:05 -05:00
Mao Zhongyi
831cbfb285 SubmittingPatches: fix the spelling error
Signed-off-by: Mao Zhongyi <maozy.fnst@cn.fujitsu.com>
2018-05-31 20:35:39 +08:00
Nathan Cutler
47ff2bf0d5 doc/SubmittingPatches.rst: rv double spaces and Please
Signed-off-by: Nathan Cutler <ncutler@suse.com>
2018-05-23 20:29:37 +02:00
Nathan Cutler
6f2e7cada8 doc/SubmittingPatches.rst: use Google style guide for doc patches
Signed-off-by: Nathan Cutler <ncutler@suse.com>
2018-05-23 20:24:23 +02:00
Nathan Cutler
c8cefc3a5b doc: SubmittingPatches: clarify PR title section
There is no real limit on the length of PR titles, other than whatever limit is
imposed by the GitHub GUI/API.

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2017-08-22 11:06:04 +02:00
John Spray
b0b931858d doc: add doc requirements on PR submitters
Signed-off-by: John Spray <john.spray@redhat.com>
2017-07-19 20:00:10 -04:00
Nathan Cutler
736b8039f5 doc: clarify SubmittingPatches.rst
This commit clarifies that folks opening bugfix PRs that need backporting to
one or more stable branches should always target master, and that the
backporting itself takes place only after the master PR is merged.

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2017-01-18 22:20:17 +01:00
Kefu Chai
68ba90d629 doc: remove ending period in section titles
Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-10-26 17:53:22 +08:00
Kefu Chai
3898dc0123 doc: reindent SubmittingPatches
otherwise the content will be rendered as block quotation.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-10-20 12:13:52 +08:00
Kefu Chai
f40296165f doc: reformat SubmittingPatches with more rst syntax
* group some paragraphs into sections, so we can link to them via its
  html anchor.
* remove unrelated contents.
* add cross-refs.

Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-10-20 11:54:10 +08:00
Nathan Cutler
65770059cb doc: amend Fixes instructions in SubmittingPatches
Since the "Fixes: #..." line is interpreted by GitHub as referring to a
pull request, yet the intention is for it to refer to the tracker issue,
change our instructions to use the full tracker issue URL.

Now that github pull request numbers are in the 8000s, there are cases when
a PR is wrongly closed by a "Fixes: #..." line in a commit message. See

https://github.com/ceph/ceph/pull/8286#event-603120191

for one such case.

Signed-off-by: Nathan Cutler <ncutler@suse.com>
2016-03-25 17:39:39 +01:00
Kefu Chai
4d00a1418e SubmittingPatches: rebase to resolve conflicts
pull request is not supposed to contain merge commits

Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-21 13:12:48 +08:00
Kefu Chai
a2c1b53684 SubmittingPatches: sending kernel patches to mailing list
Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-21 13:12:48 +08:00
Kefu Chai
18409a897b SubmittingPatches: add doc for commit title
explain that we need a prefix in the commit title

Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-21 13:12:48 +08:00
Kefu Chai
dbabbd03b7 SubmittingPatches: add doc for "Fixes:" tag
Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-21 12:27:54 +08:00
Kefu Chai
2b5588a1a8 SubmittingPatches: update with reST syntax
Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-21 12:27:54 +08:00
Kefu Chai
a9cd257513 doc: rename SubmittingPatches to SubmittingPatches.rst
for better reading experience

Signed-off-by: Kefu Chai <kchai@redhat.com>
2016-01-20 13:28:38 +08:00