From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andrew Cooper Subject: [RFC v2 for-4.6 0/2] In-tree feature documentation Date: Tue, 25 Aug 2015 11:40:26 +0100 Message-ID: <1440499228-961-1-git-send-email-andrew.cooper3@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org To: Xen-devel Cc: Juergen Gross , Lars Kurth , Wei Liu , Ian Campbell , Andrew Cooper , Ian Jackson , Tim Deegan , Jim Fehlig , Jan Beulich List-Id: xen-devel@lists.xenproject.org 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. v2 Adds %Revision and #History table, following feedback from v1. 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 | 100 ++++++++++++++++++++++++++++++++++++++++ docs/features/template.pandoc | 67 +++++++++++++++++++++++++++ 3 files changed, 168 insertions(+), 1 deletion(-) create mode 100644 docs/features/migration.pandoc create mode 100644 docs/features/template.pandoc -- 1.7.10.4