Linux-man Archive on lore.kernel.org
 help / color / Atom feed
* Re: [PATCH] Add some tips for how to contribute
       [not found] <20190807015026.26519-1-pabs3@bonedaddy.net>
@ 2019-09-13 13:59 ` Michael Kerrisk (man-pages)
  2019-09-14  0:26   ` Paul Wise
  0 siblings, 1 reply; 2+ messages in thread
From: Michael Kerrisk (man-pages) @ 2019-09-13 13:59 UTC (permalink / raw)
  To: Paul Wise; +Cc: mtk.manpages, linux-man

Hello Paul,


On 8/7/19 3:50 AM, Paul Wise wrote:
> Written-by: Michael Kerrisk <mtk.manpages@gmail.com>
> ---
>  CONTRIBUTING | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)
>  create mode 100644 CONTRIBUTING
> 
> diff --git a/CONTRIBUTING b/CONTRIBUTING
> new file mode 100644
> index 000000000..db947b5af
> --- /dev/null
> +++ b/CONTRIBUTING
> @@ -0,0 +1,16 @@
> +Commit style:
> +
> +When referring to Linux kernel versions, please add a
> +comment before it that shows the kernel commit hash.
> +
> +Use .PP rather than blank lines as paragraph separators.
> +
> +Starting new sentences on new source lines makes future patches against
> +the source easier to grok. This is known as semantic newlines:
> +
> +https://rhodesmill.org/brandon/2012/one-sentence-per-line/
> +
> +Sending patches:
> +
> +To: Michael Kerrisk (man-pages) <mtk.manpages@gmail.com>
> +CC: linux-man@vger.kernel.org

Pretty much all of the above is covered either on the
project website, or in man-pages(7). (I just added a note
to man-pages(7) about avoiding blank lines as separators, 
and further enhanced the discussion of semantic newlines.)

But of course, your meta-point is: let's make things more
visible. I instead added a CONTRIBUTING file as below.

Thanks for the idea!

Cheers,

Michael

diff --git a/CONTRIBUTING b/CONTRIBUTING
new file mode 100644
index 000000000..383bae5b3
--- /dev/null
+++ b/CONTRIBUTING
@@ -0,0 +1,13 @@
+For general information about how to contribute, see:
+https://www.kernel.org/doc/man-pages/contributing.html
+
+For information on how to send patches, see:
+https://www.kernel.org/doc/man-pages/patches.html
+
+For a description of the preferred layout of manual pages,
+as well as some style guide notes, see:
+
+    $ man 7 man-pages
+
+For information about reporting bugs, see:
+https://www.kernel.org/doc/man-pages/reporting_bugs.html


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] Add some tips for how to contribute
  2019-09-13 13:59 ` [PATCH] Add some tips for how to contribute Michael Kerrisk (man-pages)
@ 2019-09-14  0:26   ` Paul Wise
  0 siblings, 0 replies; 2+ messages in thread
From: Paul Wise @ 2019-09-14  0:26 UTC (permalink / raw)
  To: Michael Kerrisk (man-pages); +Cc: linux-man

[-- Attachment #1: Type: text/plain, Size: 593 bytes --]

On Fri, 2019-09-13 at 15:59 +0200, Michael Kerrisk (man-pages) wrote:

> Pretty much all of the above is covered either on the
> project website, or in man-pages(7). (I just added a note
> to man-pages(7) about avoiding blank lines as separators, 
> and further enhanced the discussion of semantic newlines.)

I see, I hadn't seen that as I just had a git repo checkout.

> But of course, your meta-point is: let's make things more
> visible. I instead added a CONTRIBUTING file as below.

Exactly. Looks great, thanks for that.

-- 
bye,
pabs

https://bonedaddy.net/pabs3/

[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, back to index

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
     [not found] <20190807015026.26519-1-pabs3@bonedaddy.net>
2019-09-13 13:59 ` [PATCH] Add some tips for how to contribute Michael Kerrisk (man-pages)
2019-09-14  0:26   ` Paul Wise

Linux-man Archive on lore.kernel.org

Archives are clonable:
	git clone --mirror https://lore.kernel.org/linux-man/0 linux-man/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 linux-man linux-man/ https://lore.kernel.org/linux-man \
		linux-man@vger.kernel.org
	public-inbox-index linux-man

Example config snippet for mirrors

Newsgroup available over NNTP:
	nntp://nntp.lore.kernel.org/org.kernel.vger.linux-man


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git