README.md: describe preferred flow for comments
PATCH 1/1 README.md: describe preferred flow for comments
We prefer receiving comments as patches.
Describe how to generate them.
Signed-off-by Michael S. Tsirkin <[email protected]>
---
Ariel, Yoni, does the following seem helpful to you? Any comments?
README.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-)
README.md +31 -2
@@ -30,11 +30,40 @@ <h3>Further Description of this Repository</h3> <h4>Providing Feedback</h4> +Feedback must be provided the <strong>virtio-comment</strong> mailing list, +and archived in the mailing list archives. <p>See <A HREF="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=virtio#feedback"> https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=virtio#feedback</A> -<h4>Note for Contributors</h4> -<p>Contributors should review TC specific +<p>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. +<p>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: +<code> +<p> +git clone https://github.com/oasis-tcs/virtio-spec.git<br> +... edit spec text, and save ...<br> +<p> +git commit -a<br> +... describe the proposed change, in the following format:<br> +single line summary<br> +<br> +detailed description, including motivation for the change<br> +<br> +Signed-off-by: Name <email><br> +... then save and close the editor ... <br> +<p> +git format-patch -o proposal1/ HEAD~1..<br> +... generates a new directory proposal1/ and a file starting with 0001- ...<br> +<p> +git send-email [email protected] proposal1/0001-* +</code> +<h4>Note for TC Members</h4> +<p>TC Members should review TC specific process rules under "Further Description of this Repository" in <A HREF="https://github.com/oasis-tcs/virtio-admin">https://github.com/oasis-tcs/virtio-admin</A>.
Signature · 6 lines
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
Quoted 11 lines · Michael S. Tsirkin
We prefer receiving comments as patches.
Describe how to generate them.Signed-off-by Michael S. Tsirkin <[email protected]>---
Ariel, Yoni, does the following seem helpful to you? Any comments?
README.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-)
Reviewed-by Stefan Hajnoczi <[email protected]>