From: Andrew Cooper <andrew.cooper3@citrix.com>
To: Xen-devel <xen-devel@lists.xen.org>
Cc: Lars Kurth <lars.kurth@citrix.com>, Wei Liu <wei.liu2@citrix.com>,
Ian Campbell <Ian.Campbell@citrix.com>,
Andrew Cooper <andrew.cooper3@citrix.com>,
Ian Jackson <Ian.Jackson@eu.citrix.com>, Tim Deegan <tim@xen.org>,
Jim Fehlig <jfehlig@suse.com>, Jan Beulich <JBeulich@suse.com>
Subject: [RFC for-4.6 0/2] In-tree feature documentation
Date: Mon, 24 Aug 2015 18:37:00 +0100 [thread overview]
Message-ID: <1440437822-29490-1-git-send-email-andrew.cooper3@citrix.com> (raw)
An issue which Xen has is an uncertain support statement for features.
Given the success seen with docs/misc/xen-command-line.markdown, and in
particular keeping it up to date, introduce a similar system for
features.
Patch 1 introduces a proposed template (and a makefile tweak to include
the new docs/features subdirectory), while patch 2 is a feature document
covering the topic of migration.
This is tagged RFC as I expect people to have different views as to what
is useful to include. I would particilarly appreciate feedback on the
template before it starts getting used widely.
Lars: Does this look like a reasonable counterpart to your formal
support statement document?
Jim: Per your request at the summit for new information, is patch 2
suitable?
Andrew Cooper (2):
docs: Template for feature documents
docs: Migration feature document
docs/Makefile | 2 +-
docs/features/migration.pandoc | 90 ++++++++++++++++++++++++++++++++++++++++
docs/features/template.pandoc | 55 ++++++++++++++++++++++++
3 files changed, 146 insertions(+), 1 deletion(-)
create mode 100644 docs/features/migration.pandoc
create mode 100644 docs/features/template.pandoc
--
1.7.10.4
next reply other threads:[~2015-08-24 17:37 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-08-24 17:37 Andrew Cooper [this message]
2015-08-24 17:37 ` [PATCH for-4.6 1/2] docs: Template for feature documents Andrew Cooper
2015-08-24 19:27 ` Juergen Gross
2015-08-24 22:52 ` Andrew Cooper
2015-08-24 22:58 ` Juergen Gross
2015-08-25 8:41 ` Wei Liu
2015-08-25 10:06 ` Andrew Cooper
2015-08-24 17:37 ` [PATCH for-4.6 2/2] docs: Migration feature document Andrew Cooper
2015-08-25 8:49 ` Wei Liu
2015-08-25 10:05 ` Andrew Cooper
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1440437822-29490-1-git-send-email-andrew.cooper3@citrix.com \
--to=andrew.cooper3@citrix.com \
--cc=Ian.Campbell@citrix.com \
--cc=Ian.Jackson@eu.citrix.com \
--cc=JBeulich@suse.com \
--cc=jfehlig@suse.com \
--cc=lars.kurth@citrix.com \
--cc=tim@xen.org \
--cc=wei.liu2@citrix.com \
--cc=xen-devel@lists.xen.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).