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

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.

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.

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)

On Tue, 2012-03-20 at 15:17 +0000, Teo En Ming (Zhang Enming)
wrote:
> How about MS Word .doc format? I believe HTML is easily editable by a 
> suitable HTML editor.
Neither of these are usable in a collaborative manner. We have a wiki
for exactly this sort of content.
> 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?
Sorry but no, I don''t think www.xen.org is the right place to host this
content.

IMHO the wiki is the right place to do this. We use media wiki which is
very common (it also runs wikipedia) and so there should be plenty of
help available via search engines etc. As a starting point there are
several howto guides linked from the main page of wiki.xen.org.

Ian.

> -----Original Message-----
> From: xen-devel-bounces@lists.xen.org [mailto:xen-devel-
> bounces@lists.xen.org] 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@lists.xen.org
> 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@lists.xen.org
> http://lists.xen.org/xen-devel

On 21/03/2012 00:25, djmagee@mageenet.net wrote:
>> -----Original Message-----
>> From: xen-devel-bounces@lists.xen.org [mailto:xen-devel-
>> bounces@lists.xen.org] 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@lists.xen.org
>> 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@lists.xen.org
>> http://lists.xen.org/xen-devel
Dear Doug,

I will try to see if there is any way I can publish my HTML 
documentation in Xen Wiki.

Thank you very much.

Yours sincerely,

Teo En Ming (Zhang Enming)

On 20/03/2012 23:24, Ian Campbell wrote:
> On Tue, 2012-03-20 at 15:17 +0000, Teo En Ming (Zhang Enming) wrote:
>> How about MS Word .doc format? I believe HTML is easily editable by a
>> suitable HTML editor.
> Neither of these are usable in a collaborative manner. We have a wiki
> for exactly this sort of content.
>
>> 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?
> Sorry but no, I don''t think www.xen.org is the right place to host
this
> content.
>
> IMHO the wiki is the right place to do this. We use media wiki which is
> very common (it also runs wikipedia) and so there should be plenty of
> help available via search engines etc. As a starting point there are
> several howto guides linked from the main page of wiki.xen.org.
>
> Ian.
>
>
>
Dear Ian,

I will try to ask Pasi if he can do me a favor by importing/converting 
my HTML article into Xen WIKI.

Thank you.

Yours sincerely,

Teo En Ming (Zhang Enming)