Andrew Jensen wrote:
Hello there,
Hopfully I am doing this properly this time.
I would like to request author role on the board.
At the moment, I can not help on the users manual, this situation will
change in roughly 90 days. I would like to publish a few tutorials via
this board, and could very much use (need would be more accurate) the
review process the board would offer.
What I am not - a published author.
What I can offer - Twenty years of software development experience,
most in the commercial world. This includes work on more then a few
users manuals, help systems and SOP manuals. Seven years management
and senior management of development organizations, working with
designers and builders of code, and developers of technical and user
documentation.
I would not pretend to be able to offer much assistance as an editor
for style, beyond what I find pleasing, but I can and would offer feed
back from a technical stand point.
Looking forward to hearing from you all, hoping to help where I can
with the projects and learn what I can about writing prose for an
international audiance.
Andrew Jensen
Hi Andrew,
It looks like Marko got you set up with the author role. Sorry for not
responding to your earlier message. I had flagged it to follow up, and
never got a "round to-it".
There is an area of the site for tutorials, which you may have already
found, at <http://oooauthors.org/en/members/tutorials/>. We don't have
quite as much infrastructure for tutorials, such as templates, as we do
for the User Guide and how-tos. You'll see that some of the tuturials in
that folder are HTML pages, and some are OOo or PDF files. The
"multi-lingual" tutorials appear to use a version of the User Guide
template (which has been updated since those were written).
I'd suggest starting with the User Guide template for your tutorial
documents, and adapting it as needed for your purposes. You can create a
folder for your tutorial and post your database file along with your
document. Post them separately, rather than zipped, at least to start
with. I'm not quite sure how we'll handle publishing them to
documentation.openoffice.org (as we do with the User Guide chapters),
but we'll figure that out when that time gets closer.
You should be able to use the site's "state" mechanism for reviewing and
publishing your documents. Take a look at "Contributor Resources"
<http://oooauthors.org/en/authors/userguide2/resources/> to understand
how our process works.
Once again, welcome!
--
Janet Swisher --- Senior Technical Writer
Enthought, Inc. http://www.enthought.com
