| |
Project Manager's Guide
The
Content Provider's FAQ
describe the life of a Distributed Proofreaders project
up to the point at which the image files and text files
have been uploaded to the DP server.
This document describes everything that happens after that,
from the point of view of a Project Manager (PM).
PMs are welcome to do the prep work on their project,
or they can choose to manage a project that someone else has prepared.
To become a PM, send an email to Nikola.
Contents:
Project Manager's Workflow
See also the DP Workflow Diagram,
which gives an overview of how material moves through the site
and what the PMs do.
- Create the project on the DP website.
On the main PM page (at the top) is a link to the "Create Project" page.
After you create your project, it will be listed on your PM page.
Each project has an "Edit Comments" link.
You can email Robert or Charlz for a file containing the "standard"
comments or make up anything you like.
HTML is allowed in the comments including links to example pictures.
You should be able to use any characters in the comments.
- Release the project for proofreading.
This is done by toggling the "Availability" of the project on the PM's page.
The project will be added to the site's queueing system,
which tries to ensure an even mix of books in proofreading.
In particular, it won't allow more than one book by the same author
in First Round at the same time.
So if you have 4 volumes of a series, all by the same author,
you can put them all into 'Waiting to be Released' at once,
but the software will only allow one of them in First Round at a time.
- Shepherd the project through the site.
There are 4 main tasks you will need to perform to assure your project runs smoothly through the site.
All these tasks are done via the Project Page using the links provided.
-
Delete duplicate pages.
Sometimes a page will be submitted more than once.
We think this is caused by the proofreader clicking "Save as 'Done' & Proof Next" more than once.
You can review the submitted text by clicking on the text file name.
Delete all but one copy of the file by clicking on the Delete link for that file.
-
Check in MIA's.
Sometimes a proofreader will request a page but never turn it back in.
To make the page availible again, first identify the missing pages.
You can do this by scanning down the list and comparing the index number with the file number.
When they get out of sync, you've got an MIA.
To check them back in, click the link to get your entire file list.
During the 1st round this is the "View Master Files" link.
During the 2nd round, it is the "View all level 2 files" link.
Find your MIA and click on "Check In".
Don't get too anxious when checking in MIA's.
If your MIA is near the bottom then a proofreader may still be working on it.
-
Promote files.
When a project finishes the 1st round
and you have deleted all duplicates
and all the MIA's have been checked in and proofread,
click on the "Promote All" link.
This will move your project to the second round.
-
Answer proofreader's questions.
Depending on the project, you may get a lot of question emails.
Please be patient with the proofreaders as many of them will be newbies.
If you get a lot of the same questions you may consider modifying your comments.
We are working on a script that will automate task #2 and have talked about automating task #3.
Tasks 1 & 4 will probably always be done by the PM.
The client has features designed to help prevent duplicates and MIA's.
As more people start using the client you should see a reduction in their occurence.
- Download the output from the site and massage it into a postable e-text.
After all the pages have gone through both rounds of proofreading,
the site will stitch together the resulting page-texts
(with page separators)
and add the resulting file to the project's directory.
If you want to post-process the book,
you can download the stitched-together file by selecting D/L on the PM page,
or Download Zipped Text on the post-processing page.
Then follow the instructions in the
Post-Processing FAQ.
Or you can
make the project available
for someone else to post-process.
(They will find it on the post-processing page,
and check it out by selecting Check Out Book.)
- Submit the finished e-text to Project Gutenberg
On your first few projects,
you probably want to send it to fvandrog for posting.
(Please include your "raw" file that you downloaded from the site,
as this helps tremendously.)
He will review it, give you feedback, and submit it to PG.
After you are confident,
you can submit them on your own.
This page is the default PM page.
That is, it is the page that a PM will normally be directed to after signing in
and after various other operations.
You can also get to it from the other PM pages
by clicking on the "Search Your Projects" link near the top of the page.
Matching for fields other than State
is case-insensitive and unanchored.
So, for instance, 'jim' matches both 'Jimmy Olsen' and 'piggyjimjams'.
If desired, you should be able to select multiple values
for State (e.g., by holding down Ctrl).
Click on the title of a project to view its details.
The "Pages Left" column of the projects table was removed
to speed up assembly of the PM page,
and reduce the load on the server.
Note that the "Pages Remaining to be Proofread" for a project
is still available, on its Project Details page.
Add Text+Images from uploads Account
You can now specify a directory
(in the uploads account)
from which to add text+images into your project.
This means that you are now free to choose the name
of the upload directory you create,
instead of having to use the project's ID.
(E.g., you might choose to give it the same name
as the corresponding directory on your local machine.)
Of course, the project's ID will still work fine
as the name of the directory, and is in fact the default
for the Add Text+Images button.
Moreover, the string you type is actually interpreted as a 'path'
(relative to the root of the uploads account),
so it can be a directory within a directory.
For instance, you may find it convenient to create a personal directory
in the uploads account,
and then create your project-specific directories within it.
(If you do this, it's recommended that you use your DP login name
for the name of the personal directory,
as that may be an assumed default in the future.)
When you click on the "Add" button,
it copies all .png files into the project's directory,
and adds the page-texts to the project's page-table.
Delete All Text
The "Delete All Text" link (if present) is now at the very bottom of this page,
to lessen the chance of hitting it by accident.
This is a temporary measure
until a proper "Are You Sure?" prompt is implemented.
Document History
- 2001-12-17: first written by
Charles Franks
charlz@lvcablemodem.com
and
Robert Rowe
robert_rowe@yahoo.com
- 2002-06-02: Updated
- 2003-07-25: jmdyck: eliminated overlap with the
Content Provider's FAQ and the
Post-Processing FAQ.
Reorganized the remainder.
(It still needs updating, but that should be easier now.)
- 2003-07-25: jmdyck: added notes on PM pages.
- 2004-05-24: jmdyck: minor edits to eliminate remarks in red.
- 2004-07-25: donovan: minor edits to conform to post-process* terminology and valid html compliance.
- 2004-07-31: donovan: minor edits to conform to proofreading* terminology.
|
