Re: [MirageOS-devel] Doc Day Tomorrow: Mirage V2

[Anil Madhavapeddy <anil@xxxxxxxxxx>]

I'd love to contribute to this, but a number of us are travelling today (Mort and I are currently in Sweden about to deliver a tutorial in an hour, Dave is on vacation).  If anyone else is free, this is of course open to anyone to contribute.

Amir, could we get this on the agenda for the next Mirage call to have an organized doc push for the next regular Xen docs day?  

In general, we need to understand how to coordinate the Xen wiki and the Mirage website, or else things get out of sync very fast indeed.  It can't be a straight copy-and-paste since the emphasis is slightly different between the two.

There's also the growing number of blog posts from the community about unikernels, and one thing we could do on the doc day is to crib some of the (excellent) content from there with the authors' permission and use that as the basis for the content.

-anil

On 29 Jul 2014, at 20:28, Russell Pavlicek <russell.pavlicek@xxxxxxxxxx> wrote:

Greetings Miragites!

Document Day for Wiki.XenProject.org is tomorrow (Wednesday).

With the release of Mirage V2, it seems to me that some basic documentation of Mirage V2 should find its way intoWiki.XenProject.org. Certainly, there are some pages already assembled under the "Mirage" category, but I think there is far more to be said.

After talking with Richard at OSCON, I am convinced that we need a "Why Mirage?" type document on the Xen Project wiki -- a document which explains why this concept of library OS/Cloud OS/unikernel should be of interest to users.  I've started a page called "Cloud Operating Systems" which tries to address the concept at a very high level.  It would be good to see that tie in to a more detailed page -- although not in the technical weeds -- which explains why Mirage itself is worth exploring.  What problems can it solve?  Why should people looking at Linux Containers look at Mirage?  What current and future scenarios will it facilitate?  Basically, something similar to your "Overview of Mirage" page on your website, complete with links to your docs, needs to be presented on our wiki.

I know many pages of excellent docs are in place on your own website, and those should stay where they are right now.  But it would be extremely useful to see some basic introductory information on the Xen Project Wiki with links to the appropriate details on the Mirage docs.  Readers of the Xen Project Wiki should be enticed to learn more about Mirage.  Right now, we lack the interesting introductory material which will draw them over to your site.

If anyone is willing to pitch in tomorrow to help create a page (or pages) on Wiki.XenProject.org to lead folks to the Mirage docs and blogs, that would be wonderful!

The usual Doc Day info can be found here:

http://wiki.xenproject.org/wiki/Xen_Project_Document_Days

Hope to see you tomorrow on #xendocs!

Russ Pavlicek
Xen Project Document Day Noisemaker

Home Office: +1-301-829-5327
UK VoIP: +44 1223 852 894

_______________________________________________
MirageOS-devel mailing list
MirageOS-devel@xxxxxxxxxxxxxxxxxxxx
http://lists.xenproject.org/cgi-bin/mailman/listinfo/mirageos-devel

_______________________________________________
MirageOS-devel mailing list
MirageOS-devel@xxxxxxxxxxxxxxxxxxxx
http://lists.xenproject.org/cgi-bin/mailman/listinfo/mirageos-devel