Matthew,
That is very astute of you! I probably would not have thought to check.
It is always a struggle to decide if you should spend time creating the
material again, or if you should not take the time.
In the macro documentation, for one topic I chose to provide a single
simple example, and then refer the user to another chapter in a
different guide for more complete coverage. At another time, I simply
provided a reference to the other chapter.
I am of the opinion that is is fine to say something like:
XForms contain significant functionality in common with forms. It is
recommended, therefore, that you read <insert reference here> blah blah
blah...
I am very glad that you are taking this on!
[EMAIL PROTECTED] wrote:
I read through Chapter 15, "Working with Forms", and it looks like there's a lot
of common information between basic forms and XForms. If I were to add content
to the XForms section of this chapter, would it be correct to assume that the
user has (or can) read the rest of the chapter so I don't need to rehash
information?
Quoting Jean Hollis Weber <[EMAIL PROTECTED]>:
Matthew Harrison wrote,
Is there anyone working on XML Forms documentation currently? And if I'm
interested in writing this, how do I get started?
Welcome, Matthew!
How to get started: first, you need Author privileges. If your username at
OOoAuthors is MHarrison, then you should now have those privileges (I added
them a few minutes ago for that username). You will need to log off the
site and log back on for the change to be effective.
Next, look on the first page of the English part of the website for links
to our style guide, writers' guide, and other info for writers, and look at
a few existing chapters for an idea of our writing and organisational
style. Chapter 15, "Working with Forms" in the Writer Guide, would be a
good one.
Your material could become a chapter in one of the books, or it could be a
stand-alone how-to or tutorial. The final form of publication doesn't
matter a lot at this stage, as that can be changed later on.
And don't be too concerned about your writing or the quality of your
supporting graphics, because the reviewers and editors can tidy up the
rough edges if necessary. Some of our writers are very good on their own,
but most of the chapters are group efforts.
The website also explains how to upload files and various other
"housekeeping" things, but if you have any problems, let us know.
--Jean
--
Andrew Pitonyak
My Macro Document: http://www.pitonyak.org/AndrewMacro.odt
My Book: http://www.hentzenwerke.com/catalog/oome.htm
Info: http://www.pitonyak.org/oo.php
See Also: http://documentation.openoffice.org/HOW_TO/index.html
