[Live-demo] Virtual machine overview documents

Cameron Shorter cameron.shorter at gmail.com
Sun Jul 29 16:52:04 PDT 2012

We discussed what VM docs to write in our daily IRC meeting today, and 
agreed that we would only want 1 VM doc.

It is important to note the importance of keeping docs concise because 
it is less words to read, it is easier to manage review and translation, 
and it is easier to translate.

Could you please:
1. Move vmdk_quickstart into virtualbox_quickstart.
2. The old virtualbox_quickstart text is to be deprecated
3. Combine elements of virtualization_quickstart into the new 
4. Any extra text you wish to keep to be moved into a wiki page and 

Feel free to try catching one of us on irc://freenode.net#osgeolive if 
you wish to discuss.

On 30/07/2012 5:08 AM, Micha Silver wrote:
> Hi Cameron:
> On 07/29/2012 03:25 AM, Cameron Shorter wrote:
>> Thanks Micha,
>> I've had a quick first pass over the virtualization_quickstart and 
>> vmdk_quickstart.
>> The vmdk quickstart looks good. I'll have a few relatively minor 
>> comments to make when I do a full review (in ~ 24 hours).
>> What I suggest is:
>> * We should only have one quickstart for VMs.
>> * So virtualization quickstart and vmdk quickstart should be combined 
>> into one.
>> * And we should deprecate the vitualbox quickstart.
>> * Actually, I think we should all 3 quickstarts should be renamed 
>> virtualbox quickstart, so that we have some history consistency, and 
>> it will be easier to track what has/has not been translated over 
>> versions of osgeolive.
> Alex mentioned adding a page describing Parallels, and Hamish wanted 
> another showing how to build a VM on Linux using libvirt. So I've left 
> it with the one *short* intro document, and the link at the bottom to 
> the details. It looks cleaner and more concise this way. And what's 
> more, we can decide whether or not to add detailed pages for other VM 
> platforms in the future. I don't see the problem with additional, 
> separate pages? Those interested will look deeper. And casual users 
> will make do with the brief overview.
> If it still looks too split up, let me know and I'll merge the two 
> pages into one.
> Regards,
> Micha
>> On 28/07/12 19:48, Micha Silver wrote:
>>> On 07/28/2012 01:11 AM, Cameron Shorter wrote:
>>>> Micha,
>>>> Are you still good for your offer to write a VM Howto?
>>>> We were discussing this in our daily IRC meeting and agreed that it 
>>>> would be good to have one.
>>> I'll give it a shot over this weekend.
>>> Your guidelines seem fine. As I mentioned, I'll put together a VM 
>>> overview, covering only the "why" and machine requirements. Then it 
>>> will have links to:
>>>  *   your current page
>>>  * setting up a virtualbox VM straight from the *.vmdk version of the
>>>    Live DVD.
>>>  * the VM wiki page
>>> That should be an improvement.
>>> Thanks,
>>> Micha
>>>> What I suggest is:
>>>> 1. Try to ensure that the doc is concise, so there is less to 
>>>> translate. (The current VM that I wrote is too long).
>>>> 2. Describe how to set up a VM for only one VM. Our quickstarts 
>>>> should be quick, (and easy to maintain), and shouldn't confuse 
>>>> users by asking them to decide on which VM to use.
>>>> 3. I'm open to suggestions re which VM you think you should write 
>>>> to. I'd guess you would select the easiest, or most widely used 
>>>> Open Source VM, but this will probably be your call.
>>>> 4. Finish with a link to an OSGeo-Live-VM wiki page. The wiki page 
>>>> can include much more detail, including how to install multiple 
>>>> versions of VMs.
>>>> Lastly, I'm being really bad by hoping to get some docs within a 
>>>> day or 2 - which will be required if we are to give translators 
>>>> enough time to translate it. (I'm also hoping to review it for you).
>>>> I've created an issue to track this here:
>>>> https://trac.osgeo.org/osgeo/ticket/966
>>>> On 25/07/12 12:28, Hamish wrote:
>>>>> Cameron wrote:
>>>>>>   I suggest that we should:
>>>>>>   1. Describe one way to create a VM inside OSGeo docs
>>>>>>   2. Describe one way to create an ISO inside OSGeo docs
>>>>>>   Point to wiki pages where we can describe multiple ways for
>>>>>>   creating ISO/VMs.
>>>>> or perhaps just describe what a VM is, how it works, and what you 
>>>>> need
>>>>> to run one on the disc, + the link to the rich mediawiki howtos 
>>>>> pages.
>>>>> Similar for booting off persistent USB sticks which may be a new 
>>>>> concept
>>>>> to some conference goers.
>>>>> 2c,
>>>>> Hamish
> -- 
> Micha Silver
> GIS Consultant, Arava Development Co.
> http://www.surfaces.co.il

Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254

Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/live-demo/attachments/20120730/1cc54b32/attachment-0001.html>

More information about the Live-demo mailing list