From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: virtio-return-3377-cohuck=redhat.com@lists.oasis-open.org Sender: List-Post: List-Help: List-Unsubscribe: List-Subscribe: Date: Tue, 18 Jun 2019 20:38:05 -0400 From: "Michael S. Tsirkin" Message-ID: <20190619003657.9637-1-mst@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Subject: [virtio] [PATCH] README.md: describe preferred flow for comments To: virtio@lists.oasis-open.org, virtio-dev@lists.oasis-open.org Cc: aadam@redhat.com, ybettan@redhat.com List-ID: We prefer receiving comments as patches. Describe how to generate them. Signed-off-by: Michael S. Tsirkin --- Ariel, Yoni, does the following seem helpful to you? Any comments? README.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d40f095..3de0c1e 100644 --- a/README.md +++ b/README.md @@ -30,11 +30,40 @@

Further Description of this Repository

Providing Feedback

+Feedback must be provided the virtio-comment mailing list, +and archived in the mailing list archives.

See https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=virtio#feedback -

Note for Contributors

-

Contributors should review TC specific +

Note that only plain text part of the message is archived, and all +attachments are stripped. Accordingly, messages sent to the +mailing list should use text/plain encoding and not +have any attachments. +

The preferred form of providing feedback is in form of a patch. +A patch can be generated and sent by cloning the spec repository, +creating a commit, formatting it as a patch and then sending it. +For example: + +

+git clone https://github.com/oasis-tcs/virtio-spec.git
+... edit spec text, and save ...
+

+git commit -a
+... describe the proposed change, in the following format:
+single line summary
+
+detailed description, including motivation for the change
+
+Signed-off-by: Name <email>
+... then save and close the editor ...
+

+git format-patch -o proposal1/ HEAD~1..
+... generates a new directory proposal1/ and a file starting with 0001- ...
+

+git send-email --to=virtio-comment@lists.oasis-open.org proposal1/0001-* + +

Note for TC Members

+

TC Members should review TC specific process rules under "Further Description of this Repository" in https://github.com/oasis-tcs/virtio-admin. -- MST --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php