[occi-wg] Editorial tool

[Gary Mazz]

+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 <andre at merzky.net> wrote:
>   
>> Quoting [Thijs Metsch] (Jul 01 2010):
>>     
>>> Date: Thu, 1 Jul 2010 03:37:22 -0400
>>> From: "Thijs Metsch" <tmetsch at platform.com>
>>> To: <occi-wg at ogf.org>
>>> 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 at ogf.org
>> http://www.ogf.org/mailman/listinfo/occi-wg
>>
>>     
> _______________________________________________
> occi-wg mailing list
> occi-wg at ogf.org
> http://www.ogf.org/mailman/listinfo/occi-wg
>
>