On 02/21/2010 01:06 PM, Claire Wood wrote:
> First of all thank you for the feedback TJ.  I have updated variable to type.

Hi Claire.

I have to agree with TJ :-) Your edits made that section a LOT more
readable.  Thank you!

The original authors (primarily developers) that section are not native
English speakers, so the grammar of their mother tongue tends to slip
into the words they write.... in much the same way I tend to use English
grammar when I write in Dutch (a second language I sort of know).


> With regard to the references to SDK versions, to save having to
> update the documentation every time the development kit is updated,
> would it not be better to have the reference as just "SDK", or are
> different versions of  SDK running simultaneously?

It is technically possible to use more than one SDK at a time (although
probably not that likely in practice).  With OOo, the SDK has changed
from one release to the next.  Documenting this is... a challenge.  Do
we document only the latest SDK? Or do we document all possible SDK
variations.. or do we document the latest method and add a Note with the
differences to past releases?  I'm not sure what the right answer is here.

In previous releases we had a much smaller number of differences... but
since the 3.x release of OOo, there is a rapidly growing number of
changes, and they are quite significant in some cases.

This is something we need to figure out... hopefully before 3.3 is
released :-) so any ideas you have are welcome!

C.
-- 
Clayton Cornell       ccorn...@openoffice.org
OpenOffice.org Documentation Project co-lead

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org

Reply via email to