Re: [Xen-users] Re: [Xen-devel] Xen document day (Oct 12 or 26)

[Lars Kurth <lars.kurth@xxxxxxx>]

Joseph,

thanks for doing this. There should be some stuff on the Wiki to build on. There are also some blog posts/blogs, which may have useful info:
- http://bderzhavets.wordpress.com/2011/10/27/set-up-oneiric-pv-domu-at-xen-4-1-2-oneiric-dom0-3-1-0-030100-generic/
- http://grantmcwilliams.com/tech/virtualization/540-updated-xen-howtos
- http://www.xen-support.com/

I managed to categorize most pages according to User / Dev / User Beginner (there are a few where I didn't get round to it though). I think another great thing for Beginners would be a new LiveCD: but nobody so far is willing to step up.

You should know that in the next few weeks we will be migrating to MediaWiki and we will make the existing Wiki RO (the plan is to have an html instance with the MoinMoin markup stored somewhere publicly or converted MoinMoin=>MediaWiki stored somewhere). So writing a Beginners Guide first is a good idea.

I am also thinking of starting the MediaWiki with very strong categorisation (i.e. every page must have a category). Categories would be:

• By audience: User, Developer, Beginner, Community, Vendor
• By lifetime:
  
• Transient: limited lifespan
  
• Archived: saved for history
  
• By project: Xen, XCP, PVOPS, XenARM, OCaml
  
• By document type:
  
• FAQ, HowTo, Tutorial, Overview
• Design
• Dev Process
  
• Compatibility
  
• Project: page related to a Xen project 
• Glossary : there is a specific way to do this in MediaWiki
  
• Index : may not be needed if we say Index=Category
  

There may be a few more. Will need to work on these a little more. It may also mean that the MediWiki instance is set up that pages must have a category and that only a subset of users can create new ones. Otherwise we get into the same mess again.

Lars

On 27/10/2011 21:23, Joseph Glanville wrote:

Great work on categorizing/marking all the pages everyone!

The path is clear now to write some really good documentation. :)

I have started work on a Beginners Guide which is effectively a step by step guide to a functional install on Debian Sqeeze.
Currently this is the most frictionless and least "magic" way to get Xen up and running and forms a good basis to experiment with more advanced Xen features.
The aim of the guide is to introduce all key concepts, get people playing with Xen in a environment that is relatively fully featured but not too daunting to setup. It covers everything from basic virtualisation, storage and networking through to starting, stopping guests and getting Windows running ontop of Xen.

You can see my progress up on this Google doc: https://docs.google.com/document/d/1q9odKP8Id26J8kHCAFt8aD5krXdUiZnZGw1Q-LGWCJg/edit
Will format for wiki and publish when it is done.

If anyone would like to contribute feel free to contact me, comments/suggestions are more than welcome.

Moving on from this I will write a more advanced Debian specific guide that delves into setting up complex networking, guest isolation techniques, storage virtualisation and all those goodies.

Very excited to see all the awesome things coming out of this and definitely recommend we have a monthly thing where we get together and decide on how we can improve documentation.
Once a direction has been established it's easy to sit down and get stuff done.

Joseph.

On 27 October 2011 21:30, Lars Kurth <lars.kurth@xxxxxxx> wrote:

On 26/10/2011 20:55, Konrad Rzeszutek Wilk wrote:

On Mon, Oct 17, 2011 at 04:37:15PM +0100, Lars Kurth wrote:

Cool.

I am wondering what people think about archiving vs deleting wiki
pages. Obviously some pages can be deleted (stuff about events, job
listings, old TODO lists, etc.).

Others may still be valuable to legacy users. See

.. snip..
Hey Lars,

I was trying to add to https://docs.google.com/spreadsheet/ccc?key=0AiRyVp8djqV3dEJRdVZaQzZmLVNKTERwMDNGaTlKdkE&hl=en_US#gid=0

a couple of things but it seems I am not authorized, anyhow these are the changes:

NetBSDdomU merge with How_to_build_NetBSD_DomU_on_Linux
2.6.18-to-2.6.31-and-higher is OK.
InstallationNotes - remove
KnownGoodImages - remove
InstallGuestImage - remove
RealModeArea - archive, or move it to be PPC/RealModeArea
USBCompatibilityList - remove
XenPCIpassthrough - keep, I just updated it
XenPVOPSDRM - keep, just updated it
XenSerialConsole - keep, I just updated it
XenPVSCSI - keep
XenUSBPassthrough - keep, just updated it
XenParavirtOps - keep, just updated it.
XenOnUbuntu64 - remove

Odd: you should have write access like anybody else. Anyway, I applied your changes.

--

Founder | Director | VP Research

Orion Virtualisation Solutions | www.orionvm.com.au | Phone: 1300 56 99 52 | Mobile: 0428 754 846

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel