[FM Discuss] Fw: Thunderbird Floss Manual - tasks and status

[Mark]

Hello All -

The Thunderbird manual team has been figuring out what it needs to do to 
finish the book and get it published. Adam thought that it would be good 
to share this discussion with the FM list. Please take a look and join 
in with suggestions and comments.

Thanks,

Mark

-------- Original Message --------
Subject: 	Re: Thunderbird Floss Manual - tasks and status
Date: 	Mon, 15 Nov 2010 11:27:46 -0500
From: 	Mark <mark.brennan at gmx.com>
To: 	jen at mozillamessaging.com, Scott Nesbitt <nesbitt.scott at gmail.com>
CC: 	adam at flossmanuals.net



Hi Jen and Scott-

I was a little unclear about how the statuses work, too. Once upon a 
time I was a print production manager for a publisher and a part of my 
job was getting documents through an editorial department. So, trying to 
put that experience to good use, here's my suggested process for how we 
can finish this project.


- Unpublished: Writing is in progress
- Needs Feedback!: The chapter needs to be reviewed and commented on by 
someone other than the writer. This is when someone should test the task 
descriptions to confirm that they are correct.
- To Be Copy-edited: Copy-edit the chapter for grammar and style but not 
for content.
- To be proofed: One last check before completion.
- Complete: Chapter is ready for publication
- Published: Chapter is in production

At this point, we have many chapters that are ready for proofreading or 
for copy-editing plus a few that are unpublished or that need feedback. 
Let's start going through them one by one until we are finished. After 
proofreading is done for a chapter, we should set it to complete. When 
all the chapters are complete, we can go ahead and publish the manual. 
Are you comfortable with is approach? Should we do it differently?

About the image that doesn't appear when viewing the page, I had the 
same issue when reviewing the Composing chapter.
I don't know what caused it and I couldn't fix it. I ended up deleting 
the picture and re-inserting it. Deleting the picture from the page 
doesn't delete it from the system so I just grabbed the existing picture 
and put it back where it belonged.

When you say the build tools, are you referring to the "Publish" button 
on the left side of the FLOSS screen? Do you know what happens when you 
push it? I'm always a little hesitant to push a button when I'm not sure 
about what happens next...

Mark



On 11/12/2010 07:30 PM, Jennifer Zickerman wrote:
> Hi Mark. On the main Thunderbird page (where the chapters are listed), 
> I see that each chapter has a status-like value ("unpublished", "to be 
> proofed", etc). Can you tell me what these statuses mean, and how I 
> can help? What is the general status on the project?
>
> Also, do you know why the link at the bottom of that page (to view the 
> manual) is 404? Adam asked me in IRC if I'd tried the build tools yet 
> - I don't know whether that was a hint or what. :)
>
> Also, I have a technical problem on the Getting Support page 
> (http://en.flossmanuals.net/bin/view/Thunderbird/GettingSupport). When 
> I edit the page, there is a graphic. But when I view the page, I only 
> see the graphic's alt tag ("thunderbird_support_search_engine "). Any 
> ideas?
>
> No worries if you don't know the answers to any of these questions - I 
> just thought I'd ask you first. :)
>
> jen.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20101115/17bade3c/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/png
Size: 25796 bytes
Desc: not available
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20101115/17bade3c/attachment.png>