Micha,
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 virtualbox_quickstart 4. Any extra text you wish to keep to be moved into a wiki page and referenced

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
http://www.lisasoft.com

_______________________________________________
Live-demo mailing list
[email protected]
http://lists.osgeo.org/mailman/listinfo/live-demo
http://live.osgeo.org
http://wiki.osgeo.org/wiki/Live_GIS_Disc

Reply via email to