Re: [Xen-devel] [REQUEST] Request for Hosting My Xen HowTo/Tutorial/Documentation on www.xen.org and Xen Wiki

[<djmagee@xxxxxxxxxxxx>]

> -----Original Message-----
> From: xen-devel-bounces@xxxxxxxxxxxxx [mailto:xen-devel-
> bounces@xxxxxxxxxxxxx] On Behalf Of Teo En Ming (Zhang Enming)
> Sent: Tuesday, March 20, 2012 11:17 AM
> To: Ian Campbell
> Cc: Teo En Ming (Zhang Enming); David TECHER; xen-devel@xxxxxxxxxxxxx
> Subject: Re: [Xen-devel] [REQUEST] Request for Hosting My Xen
> HowTo/Tutorial/Documentation on www.xen.org and Xen Wiki
> 
> On 20/03/2012 23:04, Ian Campbell wrote:
> > On Tue, 2012-03-20 at 03:45 +0000, Teo En Ming (Zhang Enming) wrote:
> >> Dear Xen admins,
> >>
> >> I have spent several days writing my Xen
> HowTo/Tutorial/Documentation
> >> and also testing the XL domain configuration files to make sure
they
> >> work. I have also verified that creating virtual machines with
> Virtual
> >> Machine Manager/libvirt works. I have done a lot of testing with my
> >> Xen documentation.
> > Thank you for taking the time to write this document, However I
don't
> > think PDF or HTML are appropriate methods for maintaining this
> document
> > as they are not easily editable by others.
> >
> > Please would you consider importing your content into wiki.xen.org
> > instead where it can be maintained easily by the community going
> > forward.
> >
> > Ian.
> >
> >
> >
> Dear Ian,
> 
> How about MS Word .doc format? I believe HTML is easily editable by a
> suitable HTML editor.
> 

Collaboration aside, a PDF (or HTML or Word) document isn't appropriate
for the content.  Your documents are ~260 pages, where 245 of those
pages are just one kernel config file.  It would be much more helpful on
the wiki, where you can link to the config file so people can download
it directly, and you can use the content of the wiki entry to point out
only the changes you made to the default Ubuntu config file (which I
believe you already do).

And, to the collaboration point, not everyone may be successful
following your instructions.  In this case, it would be nice if those
people can log onto the wiki and update your page to make your
documentation more verbose and explain difficulties one might encounter
and how to overcome them.  I'm sure you'd rather do this than have
people email you the same question over and over again when they're
trying to follow your PDF document that you have sole control of.  Or,
have to commit to publishing a new version of the document every time
there's a minor revision in any of the related pieces of software.  That
would get old quick...

Doug

> I am not very good with Wikis and have some difficulty creating a page
> on Wikis. Is it possible for you to help me import my content into
> wiki.xen.org or even www.xen.org?
> 
> Thank you very much.
> 
> Yours sincerely,
> 
> Teo En Ming (Zhang Enming)
> 
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@xxxxxxxxxxxxx
> http://lists.xen.org/xen-devel

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel