Impress Guide 3.4 Chapter 3 (Adding & Formatting Text) reviewed

I've put my review of Impress Guide 3.4 Chapter 3 (Adding & Formatting
Text) in the Drafts folder. Changes are tracked, and I left lots of
comments and questions for Peter.

--Jean

Hello Jane

In my opinion, captions used for figures should be as short as possible without losing any meaning and this is what I have tried to achieve. When you use a long caption, the user/reader can get confused and miss what the figure is there for. Using short captions is the way I have been trained and guided during my career.

Regards

Peter

The editors at O'Reilly, Apple, and most popular series such as Dummies and Que, evidently do not agree with you. Most figures in those books have short, explanatory captions that provide more info than just the name of the dialog. Some series, such as the Missing Manuals, go to the opposite extreme and include mini essays as figure captions; this method is not something I am advocating for us, but it definitely works for them.

And my name is Jean, not Jane.

Hello Jean

Welcome back.

New draft version of Chapter 3 has been uploaded to the ODF Authors site for
review at the following link:

http://www.odfauthors.org/libreoffice/english/impress-guide/draft-lo3.4

I agreed with your comments and changed your addition about complex text to
a note.

I think it is now ready for publishing.

Regards

Peter

Hi :slight_smile:
Peter if you have confidence in it now that Jean's changes have gone in then could you upload the chapter to the wiki?
http://wiki.documentfoundation.org/Documentation/Publications
If this is your first time and you are keen then feel free to ask for help on or off-list.  You can register yourself if you need to.  Unlike the other systems the team uses the wiki is free for anyone to register themselves at. 
Regards from
Tom :slight_smile:

Several other Impress Guide chapters are ready to upload to the wiki,
too, if I recall correctly.

BTW, I do it differently from the method Tom described in another
thread: I edit the wiki page first to put in the links and then click
on the links (red, indicating nothing there) to go to the file upload
page. The result is the same, but I do the two steps in reverse order.
I find it easier that way, but it's a case of whatever works for you.
(And my method only works for the initial uploads; to replace a file
with a newer copy, one needs to go directly to the upload page for the
file; clicking the link won't take you there.)

--Jean

Hi :slight_smile:
That sounds like a better work-flow for initial uploads. I've not done much
uploading to wiki so i haven't tried out different approaches yet.
Regards from
Tom :slight_smile:

Jean Weber wrote

Hi :slight_smile:
Ahah, excellent.  If we could get the Impress 3.4.x guide out there it would be great.  Good work on this Peter!
Regards from
Tom :slight_smile: