mailarchive of the ptxdist mailing list
 help / color / mirror / Atom feed
* [ptxdist] [PATCH 1/2] doc/contributing: absorb (and slightly update) README.devel
@ 2021-06-06 14:51 Roland Hieber
  2021-06-06 14:51 ` [ptxdist] [PATCH 2/2] README: mention raw documentation and how to build it Roland Hieber
  2021-06-16 10:35 ` [ptxdist] [APPLIED] doc/contributing: absorb (and slightly update) README.devel Michael Olbrich
  0 siblings, 2 replies; 4+ messages in thread
From: Roland Hieber @ 2021-06-06 14:51 UTC (permalink / raw)
  To: ptxdist; +Cc: Roland Hieber

Move the "How to contribute" section before the "PTXdist Packages"
section, as it applies generally and not only for packages. Update the
Git URL, and add the Git web interface too.

Signed-off-by: Roland Hieber <rhi@pengutronix.de>
---
 README.devel         | 56 ---------------------------------
 doc/contributing.rst | 74 ++++++++++++++++++++++++++++++++++++++------
 2 files changed, 64 insertions(+), 66 deletions(-)
 delete mode 100644 README.devel

diff --git a/README.devel b/README.devel
deleted file mode 100644
index ed8277cd6941..000000000000
--- a/README.devel
+++ /dev/null
@@ -1,56 +0,0 @@
-PTXdist development
-===================
-
-Development Tree
-----------------
-
-PTXdist uses git for version control. The master repository is available at
-
-	git://git.pengutronix.de/git/ptxdist.git
-
-Patch Guideline
----------------
-
-Patches for PTXdist are always welcome. If you created a patch, send it to
-ptxdist@pengutronix.de for review. Each patch accepted into the master
-repository must be certified to be compatible with PTXdist's license (GPL v2,
-see COPYING). To do this you have to sign your patches (or the ones you apply
-and/or forward). If you can certify the below:
-
-        Developer's Certificate of Origin 1.1
-
-        By making a contribution to this project, I certify that:
-
-        (a) The contribution was created in whole or in part by me and I
-            have the right to submit it under the open source license
-            indicated in the file; or
-
-        (b) The contribution is based upon previous work that, to the best
-            of my knowledge, is covered under an appropriate open source
-            license and I have the right under that license to submit that
-            work with modifications, whether created in whole or in part
-            by me, under the same open source license (unless I am
-            permitted to submit under a different license), as indicated
-            in the file; or
-
-        (c) The contribution was provided directly to me by some other
-            person who certified (a), (b) or (c) and I have not modified
-            it.
-
-        (d) I understand and agree that this project and the contribution
-            are public and that a record of the contribution (including all
-            personal information I submit with it, including my sign-off) is
-            maintained indefinitely and may be redistributed consistent with
-            this project or the open source license(s) involved.
-
-then you just add a line saying
-
-        Signed-off-by: Random J Developer <random@developer.example.org>
-
-using your real name (sorry, no pseudonyms or anonymous contributions.) at the
-end of the patch description.
-
-There are some more usual tags (like Acked-by or Reported-by) which only have
-informational character and so are not formally specified here. See the Linux
-kernel (file: Documentation/process/submitting-patches.rst) for how they are
-used here, too.
diff --git a/doc/contributing.rst b/doc/contributing.rst
index 85ee297baae0..e7cbd90e6cc3 100644
--- a/doc/contributing.rst
+++ b/doc/contributing.rst
@@ -1,19 +1,22 @@
 Contributing to PTXdist
 =======================
 
-PTXdist Packages
+Development Tree
 ----------------
 
-While contributions to all parts of PTXdist are welcome, most contributions
-concern individual packages. Here is a checklist of things to look out for
-while creating or updating packages. These are not hard requirements, but
-there should be good reasons for different choices.
+PTXdist uses Git for version control.
+The master repository is available at::
+
+   git://git.pengutronix.de/ptxdist
+
+A `Git web interface <https://git.pengutronix.de/cgit/ptxdist/>`_ is also available.
 
 How to Contribute
-~~~~~~~~~~~~~~~~~
+-----------------
 
-Contributions should be sent as patches to the :ref:`mailing_list`. This
-is usually done with ``git send-email``.
+Patches for PTXdist are always welcome.
+Contributions should be sent to the :ref:`mailing_list`.
+This is usually done with ``git send-email``.
 If you're unfamiliar with this workflow, have a look at the intro at
 `git-send-email.io <https://git-send-email.io/>`_.
 
@@ -21,8 +24,59 @@ All patches must contain a descriptive subject and should, for all
 non-obvious changes, contain a commit message describing what has changed
 and why this is necessary.
 
-All patches must contain the correct ``Signed-off-by:`` tag,
-see `README.devel <https://git.pengutronix.de/cgit/ptxdist/tree/README.devel>`_.
+Each patch accepted into the master repository must be certified to be
+compatible with PTXdist's license (GPLv2, see `COPYING`_).
+To do this you have to sign your patches (or the ones you forward).
+If you can certify the below::
+
+   Developer's Certificate of Origin 1.1
+   
+   By making a contribution to this project, I certify that:
+   
+   (a) The contribution was created in whole or in part by me and I
+       have the right to submit it under the open source license
+       indicated in the file; or
+   
+   (b) The contribution is based upon previous work that, to the best
+       of my knowledge, is covered under an appropriate open source
+       license and I have the right under that license to submit that
+       work with modifications, whether created in whole or in part
+       by me, under the same open source license (unless I am
+       permitted to submit under a different license), as indicated
+       in the file; or
+   
+   (c) The contribution was provided directly to me by some other
+       person who certified (a), (b) or (c) and I have not modified
+       it.
+   
+   (d) I understand and agree that this project and the contribution
+       are public and that a record of the contribution (including all
+       personal information I submit with it, including my sign-off) is
+       maintained indefinitely and may be redistributed consistent with
+       this project or the open source license(s) involved.
+
+then you just add a line saying::
+
+   Signed-off-by: Random J Developer <random@developer.example.org>
+
+using your real name (sorry, no pseudonyms or anonymous contributions) at the
+end of the patch description.
+
+.. _COPYING: https://git.pengutronix.de/cgit/ptxdist/tree/COPYING
+
+There are some more usual tags (like *Acked-by* or *Reported-by*) which only
+have informational character and so are not formally specified here.
+See the `Linux kernel documentation
+<https://www.kernel.org/doc/html/latest/process/submitting-patches.html>`_
+for a more complete list.
+
+PTXdist Packages
+----------------
+
+While contributions to all parts of PTXdist are welcome, most contributions
+concern individual packages. Here is a checklist of things to look out for
+while creating or updating packages. These are not hard requirements, but
+there should be good reasons for different choices.
 
 Package Builds should be Reproducible
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-- 
2.29.2


_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de


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

* [ptxdist] [PATCH 2/2] README: mention raw documentation and how to build it
  2021-06-06 14:51 [ptxdist] [PATCH 1/2] doc/contributing: absorb (and slightly update) README.devel Roland Hieber
@ 2021-06-06 14:51 ` Roland Hieber
  2021-06-16 10:35   ` [ptxdist] [APPLIED] " Michael Olbrich
  2021-06-16 10:35 ` [ptxdist] [APPLIED] doc/contributing: absorb (and slightly update) README.devel Michael Olbrich
  1 sibling, 1 reply; 4+ messages in thread
From: Roland Hieber @ 2021-06-06 14:51 UTC (permalink / raw)
  To: ptxdist; +Cc: Roland Hieber

Signed-off-by: Roland Hieber <rhi@pengutronix.de>
---
 README | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README b/README
index 60ac8b152b8b..1bf3348f81ca 100644
--- a/README
+++ b/README
@@ -48,6 +48,12 @@ Documentation
 See <https://www.ptxdist.org/doc/> for the full documentation, which
 includes a quickstart guide as well as a reference for users and
 developers.
+You can also find the documentation in reStructuredText form in the doc/
+directory inside this PTXdist tree, which you can build into HTML with
+
+    ./bin/ptxdist docs-html
+
+The generated HTML documents will be created in Documentation/html/.
 
 Bugs
 ----
-- 
2.29.2


_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de


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

* Re: [ptxdist] [APPLIED] doc/contributing: absorb (and slightly update) README.devel
  2021-06-06 14:51 [ptxdist] [PATCH 1/2] doc/contributing: absorb (and slightly update) README.devel Roland Hieber
  2021-06-06 14:51 ` [ptxdist] [PATCH 2/2] README: mention raw documentation and how to build it Roland Hieber
@ 2021-06-16 10:35 ` Michael Olbrich
  1 sibling, 0 replies; 4+ messages in thread
From: Michael Olbrich @ 2021-06-16 10:35 UTC (permalink / raw)
  To: ptxdist; +Cc: Roland Hieber

Thanks, applied as 5d2b4188eb09e15c9e18c1d8619710d01a4f0908.

Michael

[sent from post-receive hook]

On Wed, 16 Jun 2021 12:35:32 +0200, Roland Hieber <rhi@pengutronix.de> wrote:
> Move the "How to contribute" section before the "PTXdist Packages"
> section, as it applies generally and not only for packages. Update the
> Git URL, and add the Git web interface too.
> 
> Signed-off-by: Roland Hieber <rhi@pengutronix.de>
> Message-Id: <20210606145101.21027-1-rhi@pengutronix.de>
> Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
> 
> diff --git a/README.devel b/README.devel
> deleted file mode 100644
> index ed8277cd6941..000000000000
> --- a/README.devel
> +++ /dev/null
> @@ -1,56 +0,0 @@
> -PTXdist development
> -===================
> -
> -Development Tree
> -----------------
> -
> -PTXdist uses git for version control. The master repository is available at
> -
> -	git://git.pengutronix.de/git/ptxdist.git
> -
> -Patch Guideline
> ----------------
> -
> -Patches for PTXdist are always welcome. If you created a patch, send it to
> -ptxdist@pengutronix.de for review. Each patch accepted into the master
> -repository must be certified to be compatible with PTXdist's license (GPL v2,
> -see COPYING). To do this you have to sign your patches (or the ones you apply
> -and/or forward). If you can certify the below:
> -
> -        Developer's Certificate of Origin 1.1
> -
> -        By making a contribution to this project, I certify that:
> -
> -        (a) The contribution was created in whole or in part by me and I
> -            have the right to submit it under the open source license
> -            indicated in the file; or
> -
> -        (b) The contribution is based upon previous work that, to the best
> -            of my knowledge, is covered under an appropriate open source
> -            license and I have the right under that license to submit that
> -            work with modifications, whether created in whole or in part
> -            by me, under the same open source license (unless I am
> -            permitted to submit under a different license), as indicated
> -            in the file; or
> -
> -        (c) The contribution was provided directly to me by some other
> -            person who certified (a), (b) or (c) and I have not modified
> -            it.
> -
> -        (d) I understand and agree that this project and the contribution
> -            are public and that a record of the contribution (including all
> -            personal information I submit with it, including my sign-off) is
> -            maintained indefinitely and may be redistributed consistent with
> -            this project or the open source license(s) involved.
> -
> -then you just add a line saying
> -
> -        Signed-off-by: Random J Developer <random@developer.example.org>
> -
> -using your real name (sorry, no pseudonyms or anonymous contributions.) at the
> -end of the patch description.
> -
> -There are some more usual tags (like Acked-by or Reported-by) which only have
> -informational character and so are not formally specified here. See the Linux
> -kernel (file: Documentation/process/submitting-patches.rst) for how they are
> -used here, too.
> diff --git a/doc/contributing.rst b/doc/contributing.rst
> index 85ee297baae0..e7cbd90e6cc3 100644
> --- a/doc/contributing.rst
> +++ b/doc/contributing.rst
> @@ -1,19 +1,22 @@
>  Contributing to PTXdist
>  =======================
>  
> -PTXdist Packages
> +Development Tree
>  ----------------
>  
> -While contributions to all parts of PTXdist are welcome, most contributions
> -concern individual packages. Here is a checklist of things to look out for
> -while creating or updating packages. These are not hard requirements, but
> -there should be good reasons for different choices.
> +PTXdist uses Git for version control.
> +The master repository is available at::
> +
> +   git://git.pengutronix.de/ptxdist
> +
> +A `Git web interface <https://git.pengutronix.de/cgit/ptxdist/>`_ is also available.
>  
>  How to Contribute
> -~~~~~~~~~~~~~~~~~
> +-----------------
>  
> -Contributions should be sent as patches to the :ref:`mailing_list`. This
> -is usually done with ``git send-email``.
> +Patches for PTXdist are always welcome.
> +Contributions should be sent to the :ref:`mailing_list`.
> +This is usually done with ``git send-email``.
>  If you're unfamiliar with this workflow, have a look at the intro at
>  `git-send-email.io <https://git-send-email.io/>`_.
>  
> @@ -21,8 +24,59 @@ All patches must contain a descriptive subject and should, for all
>  non-obvious changes, contain a commit message describing what has changed
>  and why this is necessary.
>  
> -All patches must contain the correct ``Signed-off-by:`` tag,
> -see `README.devel <https://git.pengutronix.de/cgit/ptxdist/tree/README.devel>`_.
> +Each patch accepted into the master repository must be certified to be
> +compatible with PTXdist's license (GPLv2, see `COPYING`_).
> +To do this you have to sign your patches (or the ones you forward).
> +If you can certify the below::
> +
> +   Developer's Certificate of Origin 1.1
> +   
> +   By making a contribution to this project, I certify that:
> +   
> +   (a) The contribution was created in whole or in part by me and I
> +       have the right to submit it under the open source license
> +       indicated in the file; or
> +   
> +   (b) The contribution is based upon previous work that, to the best
> +       of my knowledge, is covered under an appropriate open source
> +       license and I have the right under that license to submit that
> +       work with modifications, whether created in whole or in part
> +       by me, under the same open source license (unless I am
> +       permitted to submit under a different license), as indicated
> +       in the file; or
> +   
> +   (c) The contribution was provided directly to me by some other
> +       person who certified (a), (b) or (c) and I have not modified
> +       it.
> +   
> +   (d) I understand and agree that this project and the contribution
> +       are public and that a record of the contribution (including all
> +       personal information I submit with it, including my sign-off) is
> +       maintained indefinitely and may be redistributed consistent with
> +       this project or the open source license(s) involved.
> +
> +then you just add a line saying::
> +
> +   Signed-off-by: Random J Developer <random@developer.example.org>
> +
> +using your real name (sorry, no pseudonyms or anonymous contributions) at the
> +end of the patch description.
> +
> +.. _COPYING: https://git.pengutronix.de/cgit/ptxdist/tree/COPYING
> +
> +There are some more usual tags (like *Acked-by* or *Reported-by*) which only
> +have informational character and so are not formally specified here.
> +See the `Linux kernel documentation
> +<https://www.kernel.org/doc/html/latest/process/submitting-patches.html>`_
> +for a more complete list.
> +
> +PTXdist Packages
> +----------------
> +
> +While contributions to all parts of PTXdist are welcome, most contributions
> +concern individual packages. Here is a checklist of things to look out for
> +while creating or updating packages. These are not hard requirements, but
> +there should be good reasons for different choices.
>  
>  Package Builds should be Reproducible
>  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de


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

* Re: [ptxdist] [APPLIED] README: mention raw documentation and how to build it
  2021-06-06 14:51 ` [ptxdist] [PATCH 2/2] README: mention raw documentation and how to build it Roland Hieber
@ 2021-06-16 10:35   ` Michael Olbrich
  0 siblings, 0 replies; 4+ messages in thread
From: Michael Olbrich @ 2021-06-16 10:35 UTC (permalink / raw)
  To: ptxdist; +Cc: Roland Hieber

Thanks, applied as 5b32cf900ef10071820f4250f7181eeeb94e082f.

Michael

[sent from post-receive hook]

On Wed, 16 Jun 2021 12:35:35 +0200, Roland Hieber <rhi@pengutronix.de> wrote:
> Signed-off-by: Roland Hieber <rhi@pengutronix.de>
> Message-Id: <20210606145101.21027-2-rhi@pengutronix.de>
> Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
> 
> diff --git a/README b/README
> index 60ac8b152b8b..1bf3348f81ca 100644
> --- a/README
> +++ b/README
> @@ -48,6 +48,12 @@ Documentation
>  See <https://www.ptxdist.org/doc/> for the full documentation, which
>  includes a quickstart guide as well as a reference for users and
>  developers.
> +You can also find the documentation in reStructuredText form in the doc/
> +directory inside this PTXdist tree, which you can build into HTML with
> +
> +    ./bin/ptxdist docs-html
> +
> +The generated HTML documents will be created in Documentation/html/.
>  
>  Bugs
>  ----

_______________________________________________
ptxdist mailing list
ptxdist@pengutronix.de
To unsubscribe, send a mail with subject "unsubscribe" to ptxdist-request@pengutronix.de


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

end of thread, other threads:[~2021-06-16 10:37 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-06-06 14:51 [ptxdist] [PATCH 1/2] doc/contributing: absorb (and slightly update) README.devel Roland Hieber
2021-06-06 14:51 ` [ptxdist] [PATCH 2/2] README: mention raw documentation and how to build it Roland Hieber
2021-06-16 10:35   ` [ptxdist] [APPLIED] " Michael Olbrich
2021-06-16 10:35 ` [ptxdist] [APPLIED] doc/contributing: absorb (and slightly update) README.devel Michael Olbrich

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox