Andrew Jensen wrote:
Janet,
Alright then. Let me see if I have this understood.
I have the first tutorial written in Writer 2.0 format. It is based on
the V2.0 User Guide Chapter template. Currently it is 25 pages long,
and I suspect will be a few pages longer with the final touches to the
first draft. My preference would be to generate a PDF from this file,
but am open to change if others think HTML would be better.
Having read the sections on the review process, how to submit, how to
publish and scanning the tutorials section under Members I take that
eventually these steps will happen:
1 - Create a new section under Members-Tutorials named "Base
Tutorials" (since the tutorial is for the Base module)
2 - Create a page for the Tutorial itself named "First Database", or
something similar.
3 - "First Database" is an HTML page that covers the target reader and
an overview of what is contained in the tutorial.
4 - Within the HTML page add a link to the actual tutorial PDF file.
5 - Within the HTML page add a link to the companion ODB file.
(Actually, I have been wondering if I should include this as at
all, as the tutorial takes the reader through the process of
creating this file. My thought is that having the actual database
as it should exist when the tutorial is finished available, would
be a help.)
and that to get from here - nothing - to there - published - I start
by doing this:
1 - Create an HTML: page for "First Database" that covers the target
reader and an overview of what is contained in the tutorial.
2 - Within the HTML page add a dummy link to the actual tutorial PDF file.
3 - Within the HTML page add a dummy link to the companion ODB file.
4 - Enter "My Folder" on the site.
5 - Add new Item - this is the HTML file for the "First Database" page.
6 - Add new Item - this is the PDF file. "BaseIn60Min_17AUG05_AJ.PDF"
7 - Add new Item - this is the ODB file. "Schooldays.odb"
8 - For each of the items above change the state to "Submit"
9 - Post email to this list announcing the items availability for review.
Is this pretty much it.
Pretty much. If you want reviewers to be able to easily give you
feedback, upload your tutorial file as a native OOo file (.odt), rather
than as a PDF. Most people don't have a version of Acrobat that can make
annotations, but we all have copies of OOo ;-) Reviewers will make
changes with change-tracking turned on, so you can see what they changed
and accept or reject those changes. (They might also add comments using
the Notes feature.) For the User Guide, we still use version 1.x, even
while documenting 2.0 beta, for maximum stability. However, if 2.0 is
working for you, it's fine to keep using it.
For your HTML file, it's fine to create it locally and upload it. If
you need to update it, for example, to fix up the links to your files,
just click "edit", and you will get a form where you can edit the HTML
directly.
I would have suggested creating the new files in the Tutorials folder,
rather than in your user folder. But I'm not 100% certain that the
permissions are set up correctly for that, so do it in your user folder
for now. We can move it over to Tutorials later.
I'm about to leave my computer, so I'm afraid I won't be around this
evening to help if you run into problems. Hopefully, someone else on
the list could help you out. If not, please be patient and we'll work it
out tomorrow.
Cheers,
Janet
--
Janet Swisher --- Senior Technical Writer
Enthought, Inc. http://www.enthought.com
