- Text might be painful given we need to construct tables, markdown doesn't help out here. - I like the idea of google docs; revision history, accessible, no merge issues, collaborative - Latex, great for those who value & know it, PITA for those who've to learn it. -----Original Message----- From: occi-wg-bounces@ogf.org [mailto:occi-wg-bounces@ogf.org] On Behalf Of Andre Merzky Sent: Thursday, July 01, 2010 9:41 AM To: Thijs Metsch Cc: occi-wg@ogf.org Subject: Re: [occi-wg] Editorial tool Quoting [Thijs Metsch] (Jul 01 2010):

Date: Thu, 1 Jul 2010 03:37:22 -0400 From: "Thijs Metsch" To: Subject: [occi-wg] Editorial tool

Hi @all,

Since DocBook hasn't turned out to be the best tool for editing our specs I wanted to bring up the discussion on how the following revision should be edited. I guess we have several options - and feel free to add more:

* Word/OpenOffice Pro: Ease of use (Templates available) Contra: Merging and version control

* Latex Pro: Merging, version control easy (Andre could help with templates) Contra: Not so easy to use

* Plain TXT files in Wiki --> then use a tool for formatting when finished... Pro: Easy editable Contra: Not so cool for graphics etc. (formatting)

Google docs is another option I guess, although you cannot use the GF accounts that way. Best, Andre.

Feel free to add more and state you preference - It would be cool if in future a lot of people can help edit the specs.

Cheers,

-Thijs

-- Nothing is ever easy. _______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg ------------------------------------------------------------- Intel Ireland Limited (Branch) Collinstown Industrial Park, Leixlip, County Kildare, Ireland Registered Number: E902934 This e-mail and any attachments may contain confidential material for the sole use of the intended recipient(s). Any review or distribution by others is strictly prohibited. If you are not the intended recipient, please contact the sender and delete all copies.

+1 OO Documents can be saved in raw XML format, although the directory structure is a little complicated. OO Writer does have a convenient merge functions, versioning, comments and review. Diffs are done via "Edit->Compare Document", I think compare works as a command line, although I never needed to try it. The ODF (odt) document format is just compressed xml. Mercurial has diff scripts for odt documents, although hidden metadata is exposed and makes reviewing Mercurial diffs challenging. It runs well on MAC, Vista/x64, OpenSolaris, FreeBSD and most Linux distributions. Supports master documents, integrates with spreadsheets and drawing tools. Outputs XML and there is third party integration into wikis OO Drawbacks, It can be slow in systems with low available memory, another office framework to install, susceptible to JVM quirks. Google doc require to be connected, difficult in the air, anywhere else you cannot be connected. Latex: We may as well stay with docbook Word, if M$ would donate licenses to all editors Plain text/Wiki: Collaboration and simultaneous editing could be dicey depending on wiki and editor. Most wiki change tracking not intended for collaborative and group review processes. Personally, I think google docs is not mature enough for a production environment. cheers, gary Alexis Richardson wrote:

+1 for google docs.

On Thu, Jul 1, 2010 at 9:41 AM, Andre Merzky wrote:

...

Quoting [Thijs Metsch] (Jul 01 2010):

...

Date: Thu, 1 Jul 2010 03:37:22 -0400 From: "Thijs Metsch" To: Subject: [occi-wg] Editorial tool

Hi @all,

Since DocBook hasn't turned out to be the best tool for editing our specs I wanted to bring up the discussion on how the following revision should be edited. I guess we have several options - and feel free to add more:

* Word/OpenOffice Pro: Ease of use (Templates available) Contra: Merging and version control

* Latex Pro: Merging, version control easy (Andre could help with templates) Contra: Not so easy to use

* Plain TXT files in Wiki --> then use a tool for formatting when finished... Pro: Easy editable Contra: Not so cool for graphics etc. (formatting)

Google docs is another option I guess, although you cannot use the GF accounts that way.

Best, Andre.

...

Feel free to add more and state you preference - It would be cool if in future a lot of people can help edit the specs.

Cheers,

-Thijs

-- Nothing is ever easy. _______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg

_______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg

Might it be an option if we setup Etherpad [1] on the OGF servers? Cheers, -Thijs [1] http://code.google.com/p/etherpad/

-----Original Message----- From: occi-wg-bounces@ogf.org [mailto:occi-wg-bounces@ogf.org] On Behalf Of Michael Behrens Sent: Montag, 5. Juli 2010 16:39 To: occi-wg@ogf.org Subject: Re: [occi-wg] Editorial tool

+1 google docs. I like the ability to collaborate on-line. We can always convert later to another format if needed.

Alexis Richardson wrote:

...

+1 for google docs.

On Thu, Jul 1, 2010 at 9:41 AM, Andre Merzky wrote:

...

Quoting [Thijs Metsch] (Jul 01 2010):

...

Date: Thu, 1 Jul 2010 03:37:22 -0400 From: "Thijs Metsch" To: Subject: [occi-wg] Editorial tool

Hi @all,

Since DocBook hasn't turned out to be the best tool for editing our specs I wanted to bring up the discussion on how the following revision should be edited. I guess we have several options - and feel free to add more:

* Word/OpenOffice Pro: Ease of use (Templates available) Contra: Merging and version control

* Latex Pro: Merging, version control easy (Andre could help with templates) Contra: Not so easy to use

* Plain TXT files in Wiki --> then use a tool for formatting when finished... Pro: Easy editable Contra: Not so cool for graphics etc. (formatting)

Google docs is another option I guess, although you cannot use the GF accounts that way.

Best, Andre.

...

Feel free to add more and state you preference - It would be cool if in future a lot of people can help edit the specs.

Cheers,

-Thijs

-- Nothing is ever easy. _______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg

_______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg

-- Michael Behrens R2AD, LLC (571) 594-3008 (cell) (703) 714-0442 (land)

_______________________________________________ occi-wg mailing list occi-wg@ogf.org http://www.ogf.org/mailman/listinfo/occi-wg