Ian Laurenson wrote:
Jean Hollis Weber wrote:
http://wiki.services.openoffice.org/wiki/Main_Page
That's the one Ian Laurenson was talking about. I cannot find
anything on it relevant to creating end-user documentation. The
OOoHelpOutline section has links to various existing
documentation, but that's all.
This is indeed the wiki that I am talking about.
Saying that there is nothing on there about end-user documentation was
like my saying there was nothing on the OOoAuthors Plone site when I
joined :).
But even at the beginning, I'm sure the OOoAuthors site clearly
said that it was a place for creating user documentation. See my
suggestions below.
Thank you for clarifying the situation with the wiki, and for
inviting us to provide input.
The wiki is comparatively new, and it would be great to have input from
the OOoAuthors team:
* On how it could be improved (for example I intend to suggest that
uploading of files be allowed)
Some initial suggestions:
1) Change the name of the wiki and/or do something else to make
clear that it's intended to be used by and for more than
developers. Most people interested in producing user
documentation would probably have the same reaction I did when I
first saw the wiki: "Oh, this isn't for me" -- esp. after looking
at the list of topics that is already there.
2) Make a clearly identifed section for creating documentation
for users (as distinct from docs for developers). Even if the new
section has little or no content at this point, people can see
the intention.
3) Uploading of files (as you mentioned) is, IMO, essential.
* Discuss how it could be used for end user documentation purposes (or
what limitations may need to be overcome).
...
[remainder snipped]
I've had little experience with wikis and quite honestly at this
point I have no idea how one might use a wiki to create end-user
docs intended to be provided in ODT, PDF or printed form instead
of online form. But I'd very much like to learn more. In fact, I
need to write a short section for a textbook on this very topic,
so I have an urgent requirement to learn more!
Regards, Jean
