[ndctl PATCH] ndctl: Add CONTRIBUTING.md

[ndctl PATCH] ndctl: Add CONTRIBUTING.md

[Vishal Verma]

We were missing a CONTRIBUTING file to help new contributors follow the
expected guidelines. Add one that refers to the Linux Kernel for most of
these things, such as Coding style, Submitting Patches, and the DCO.

Cc: Dan Williams <dan.j.williams@intel.com>
Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>
---
 CONTRIBUTING.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 CONTRIBUTING.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..aa9e78d
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,31 @@
+# Contributing to ndctl
+
+Thanks for taking the time to contribute to ndctl.
+
+The following is a set of guidelines that we adhere to, and request that
+contributors follow.
+
+1. The libnvdimm (kernel subsystem) and ndctl developers primarily use
+   the [linux-nvdimm](https://lists.01.org/mailman/listinfo/linux-nvdimm)
+   mailing list for discussions as well as posting patches.
+1. Github [issues](https://github.com/pmem/ndctl/issues) are an acceptable
+   way to report a problem, but if you just have a question,
+   [email](mailto:linux-nvdimm@lists.01.org) the above list.
+1. We follow the Linux Kernel [Coding Style Guide][cs] as applicable.
+
+   [cs]: https://www.kernel.org/doc/html/latest/process/coding-style.html
+
+1. We follow the Linux Kernel [Submitting Patches Guide][sp] as applicable.
+
+   [sp]: https://www.kernel.org/doc/html/latest/process/submitting-patches.html
+
+1. We follow the Linux Kernel [DCO][dco] (Developer Certificate of Origin).
+   The DCO is an attestation attached to every contribution made by every
+   developer. In the commit message of the contribution, the developer simply
+   adds a Signed-off-by statement and thereby agrees to the DCO.
+
+   [dco]: https://developercertificate.org/
+
+1. Github Pull Requests are acceptable, but won't be merged directly, as
+   Github doesn't allow for the kernel style flow of patches where a maintainer
+   also signs off on the patches they apply.
-- 
2.14.4

_______________________________________________
Linux-nvdimm mailing list
Linux-nvdimm@lists.01.org
https://lists.01.org/mailman/listinfo/linux-nvdimm

Re: [ndctl PATCH] ndctl: Add CONTRIBUTING.md

[Dan Williams]

On Wed, Jun 27, 2018 at 4:19 PM, Vishal Verma <vishal.l.verma@intel.com> wrote:
> We were missing a CONTRIBUTING file to help new contributors follow the
> expected guidelines. Add one that refers to the Linux Kernel for most of
> these things, such as Coding style, Submitting Patches, and the DCO.
>
> Cc: Dan Williams <dan.j.williams@intel.com>
> Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>

Looks good to me,

Reviewed-by: Dan Williams <dan.j.williams@intel.com>
_______________________________________________
Linux-nvdimm mailing list
Linux-nvdimm@lists.01.org
https://lists.01.org/mailman/listinfo/linux-nvdimm

Re: [ndctl PATCH] ndctl: Add CONTRIBUTING.md

[Yasunori Goto]

Hi, Vishal-san,

> We were missing a CONTRIBUTING file to help new contributors follow the
> expected guidelines. Add one that refers to the Linux Kernel for most of
> these things, such as Coding style, Submitting Patches, and the DCO.
> 
> Cc: Dan Williams <dan.j.williams@intel.com>
> Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>
> ---
>  CONTRIBUTING.md | 31 +++++++++++++++++++++++++++++++
>  1 file changed, 31 insertions(+)
>  create mode 100644 CONTRIBUTING.md
> 
> diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
> new file mode 100644
> index 0000000..aa9e78d
> --- /dev/null
> +++ b/CONTRIBUTING.md
> @@ -0,0 +1,31 @@
> +# Contributing to ndctl
> +
> +Thanks for taking the time to contribute to ndctl.
> +
> +The following is a set of guidelines that we adhere to, and request that
> +contributors follow.
> +
> +1. The libnvdimm (kernel subsystem) and ndctl developers primarily use
> +   the [linux-nvdimm](https://lists.01.org/mailman/listinfo/linux-nvdimm)
> +   mailing list for discussions as well as posting patches.
> +1. Github [issues](https://github.com/pmem/ndctl/issues) are an acceptable
> +   way to report a problem, but if you just have a question,
> +   [email](mailto:linux-nvdimm@lists.01.org) the above list.
> +1. We follow the Linux Kernel [Coding Style Guide][cs] as applicable.
> +
> +   [cs]: https://www.kernel.org/doc/html/latest/process/coding-style.html
> +
> +1. We follow the Linux Kernel [Submitting Patches Guide][sp] as applicable.
> +
> +   [sp]: https://www.kernel.org/doc/html/latest/process/submitting-patches.html
> +
> +1. We follow the Linux Kernel [DCO][dco] (Developer Certificate of Origin).
> +   The DCO is an attestation attached to every contribution made by every
> +   developer. In the commit message of the contribution, the developer simply
> +   adds a Signed-off-by statement and thereby agrees to the DCO.
> +
> +   [dco]: https://developercertificate.org/
> +
> +1. Github Pull Requests are acceptable, but won't be merged directly, as
> +   Github doesn't allow for the kernel style flow of patches where a maintainer
> +   also signs off on the patches they apply.

In my impression, newbie may not catch where is the mailing list
for sending patch from this description, and may not understand
what is difference between "[ndctl PATCH]" and
"[PATCH] pmem/libnvdimm/dax or others".

So, I think the followings descriptions are necessary.

- specify that linux-nvdimm@lists.01.org is suitable for sending patch.
- Which is better to use [ndctl PATCH] or [PATCH] xxxx: at subject.

Thanks,




_______________________________________________
Linux-nvdimm mailing list
Linux-nvdimm@lists.01.org
https://lists.01.org/mailman/listinfo/linux-nvdimm

Re: [ndctl PATCH] ndctl: Add CONTRIBUTING.md

[Verma, Vishal L]

On Thu, 2018-06-28 at 10:11 +0900, Yasunori Goto wrote:
> Hi, Vishal-san,
> 
> > We were missing a CONTRIBUTING file to help new contributors follow
> > the
> > expected guidelines. Add one that refers to the Linux Kernel for
> > most of
> > these things, such as Coding style, Submitting Patches, and the
> > DCO.
> > 
> > Cc: Dan Williams <dan.j.williams@intel.com>
> > Signed-off-by: Vishal Verma <vishal.l.verma@intel.com>
> > ---
> >  CONTRIBUTING.md | 31 +++++++++++++++++++++++++++++++
> >  1 file changed, 31 insertions(+)
> >  create mode 100644 CONTRIBUTING.md
> > 
> > diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
> > new file mode 100644
> > index 0000000..aa9e78d
> > --- /dev/null
> > +++ b/CONTRIBUTING.md
> > @@ -0,0 +1,31 @@
> > +# Contributing to ndctl
> > +
> > +Thanks for taking the time to contribute to ndctl.
> > +
> > +The following is a set of guidelines that we adhere to, and
> > request that
> > +contributors follow.
> > +
> > +1. The libnvdimm (kernel subsystem) and ndctl developers primarily
> > use
> > +   the [linux-nvdimm](https://lists.01.org/mailman/listinfo/linux-
> > nvdimm)
> > +   mailing list for discussions as well as posting patches.
> > +1. Github [issues](https://github.com/pmem/ndctl/issues) are an
> > acceptable
> > +   way to report a problem, but if you just have a question,
> > +   [email](mailto:linux-nvdimm@lists.01.org) the above list.
> > +1. We follow the Linux Kernel [Coding Style Guide][cs] as
> > applicable.
> > +
> > +   [cs]: https://www.kernel.org/doc/html/latest/process/coding-sty
> > le.html
> > +
> > +1. We follow the Linux Kernel [Submitting Patches Guide][sp] as
> > applicable.
> > +
> > +   [sp]: https://www.kernel.org/doc/html/latest/process/submitting
> > -patches.html
> > +
> > +1. We follow the Linux Kernel [DCO][dco] (Developer Certificate of
> > Origin).
> > +   The DCO is an attestation attached to every contribution made
> > by every
> > +   developer. In the commit message of the contribution, the
> > developer simply
> > +   adds a Signed-off-by statement and thereby agrees to the DCO.
> > +
> > +   [dco]: https://developercertificate.org/
> > +
> > +1. Github Pull Requests are acceptable, but won't be merged
> > directly, as
> > +   Github doesn't allow for the kernel style flow of patches where
> > a maintainer
> > +   also signs off on the patches they apply.
> 
> In my impression, newbie may not catch where is the mailing list
> for sending patch from this description, and may not understand
> what is difference between "[ndctl PATCH]" and
> "[PATCH] pmem/libnvdimm/dax or others".
> 
> So, I think the followings descriptions are necessary.
> 
> - specify that linux-nvdimm@lists.01.org is suitable for sending
> patch.
> - Which is better to use [ndctl PATCH] or [PATCH] xxxx: at subject.

Goto-san,

These are good points. I'll update to spell out an actual email address
instead of a slightly hidden mailto: link. And I'll add a few best-
practices notes such as the "ndctl PATCH" bit.

Thanks for the feedback!

	-Vishal

> 
> Thanks,
> 
> 
> 
> 
_______________________________________________
Linux-nvdimm mailing list
Linux-nvdimm@lists.01.org
https://lists.01.org/mailman/listinfo/linux-nvdimm