On 09/25/10 01:56, Andrew Douglas Pitonyak wrote:
On 09/23/2010 09:18 PM, Jean Hollis Weber wrote:
On Wed, 2010-09-15, Andrew Douglas Pitonyak wrote:
Time permitting, I work on documentation for StarBasic and Macros in
general. I have been embedding the macros directly into the document and
providing a button to run the macro on your computer. I did this for
AndrewBase.odt (see http://www.pitonyak.org/database/AndrewBase.odt) and
I am doing this for my latest set of documentation on the language
http://www.pitonyak.org/OOME_3_0.odt
Any thoughts on this?
This works well for an ODT document, but, not for a PDF, and not if it
is moved to a WIKI. There is a definite disadvantage if this is
"wikified" and much must be done to convert the document.
Should this be moved into the standard authors project?
I have been spending much time trying to document the new statements in
StarBasic... (I hope that someone in the know answers my question on
[email protected] for the last four of five undocumented statements;
the rest I figured out from the source code and other sources).
Time, I just wish I had time... I know, who does not?
Sorry about the delay in responding to this. Here is my opinion. I hope
Clayton will comment on this too, or anyone else with an interest.
In a case like this, having the only copy in ODT seems reasonable to me.
Even though I would like to publish a PDF copy of the updated book, if
the material does not go well in that form (or in wiki form) without a
lot of extra work, then I think you should do what works best and
easiest for you.
We'd be happy to have the book (in ODT) made available through
OOoAuthors at any stage in its development and publication. Or we could
just link to its location on your website from the OOo Documentation
wiki (similar to the links from the wiki to other external sites). I
think that might be best, but Clayton may have a different idea and I'm
sure I haven't thought of all the pros and cons.
--Jean
OK.... then we can let Clayton chime in ... Keeping it on my site is
fine (and easier for me).
Given the nature of the document... it makes sense to leave it in ODT. Given
how the document is designed, I wouldn't port it to Wiki format. Better to host
it somewhere and link to it from the various Documentation access points.
We have room/space on the main Doc Project website to host it there if you want.
From there we can link to it on the Wiki and the Doc pages... the advantage of
putting it on the Doc Project site is that it's version controlled, and
accessible via direct link.
That's what I'd do :-)
C.
--
Clayton Cornell [email protected]
OpenOffice.org Documentation Project co-lead
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
