Index » PageStream Support » Documentation » Corrections for the HTML manual PgS 4.1
Sign in to add a comment Pages: 1
2002-10-27 08:35:45 CT #1
Peter Martin
From: Canada
Registered: 2006-04-15
Posts: 112

Hi Deron et all:

I must say, it's looking good. Some of the problems reported with
earlier versions are still there, so here is what I have so far.

- - - - - - - - - - - -
*** Exploring PgS/Opening a Document/How to open an existing document
***

The two information boxes (which were sidebar entries in the old
manuals) still have the same problem that I reported a year or two ago -

"page 7 - Du! I wonder how this one slipped by for so long -
The sidebar information is reversed, and was in the old manual too.
'Show all files in file selector' is selected to show all files, and
deselected to show only PgS files. I couldn't believe that it would have
been in the manual wrong, so I waited until I got home to fire up the
Amiga and check it.

Also this feature is under the Files tab of pref's, not the General tab
as
implied here."

*** Exploring PgS/Opening a Document / Font substitution ***

This problem, reported earlier, still exists -

""It may be just me but I'd like to see a difference between the action
and the object of the action. I realize that this manual is presented
the same way as the Release 3 manual, and this point must have been
discussed before with Michael Loader et all. The problem I'm pointing
out is particularly obvious in the font substitution paragraph at the
top of page 8
"Select Remember to save this substitution for future documents. Select
Display As instead of Convert To if you don't want to permanently
change the font name in the document. When you are finished, click
Done."

I'd like to see the object of the action highlighted by bolding or
changing
the font size/type/italicise. For this email example I'm going to
enclose
in single quotes.
"Select 'Remember to save this substitution for future documents'.
Select
'Display As' instead of 'Convert To' if you don't want to permanently
change the font name in the document. When you are finished, click
'Done'."
I think it would help the understandability.""


*** Exploring PgS/Opening a Document / Appending a document ***

The sub subsection "Appending a document" should be raised one level,
and have the same font size as "Opening a Document" and "Saving a
Document"

*** Exploring PgS/ The PageStream Screen/ Toolbox ***

The Toolbox descriptions have some ambiguities:-
In the first paragraph it would be good to note that the flyout tools
happen on the Amiga/Mac(?), while on Windows they are rotated through.

There is no consistency in the way the groups are indicated. Some groups
(Column, Box, Ellipse & Polygon) are clearly shown, where others are
not. I would suggest that the icons for the object group be collected
and placed in a line above the descriptions. The next lines (as they are
now, with their icons) be indented by one tab and shown as they are now.
The Path drawing group, the Pen and the Freehand & Grid group, the Grid
and the Table, should also be treated the same way.

The Table icon and description are missing.

*** Using Objects/ How to move objects ***

In this section it would be nice to add a note about moving very small
objects. - At the time the object is selected, if the mouse button is
held down, the object can be moved, but if the button is released and
then clicked again on an already selected object to start the move, you
will more-than-likely get a sizing handle and the object will be sized.

*** Using Objects/ How to resize objects/ 3. Position the mouse
pointer. ***

"Resizing an object usually changes its aspect ratio (the ratio of the
horizontal to vertical size). To resize an object proportionally, hold
down a
Shift key while you drag the mouse."

This paragraph doesn't mention the aspect ratio icon in the Edit
palette, and the fact that if the icon is set, holding down the Shift
key will allow the aspect ratio to change during the sizing action.
- - - - - - - - -

Peter Martin
pjmartin@magma.ca

2002-10-27 16:41:00 CT #2
Deron Kazmaier
From: United States
Registered: 2006-01-29
Posts: 4599

Thanks for the feedback!

> *** Exploring PgS/Opening a Document/How to open an existing document
>***
>
>The two information boxes (which were sidebar entries in the old
>manuals) still have the same problem that I reported a year or two ago -
>
>"page 7 - Du! I wonder how this one slipped by for so long -
>The sidebar information is reversed, and was in the old manual too.
>'Show all files in file selector' is selected to show all files, and
>deselected to show only PgS files. I couldn't believe that it would have
>been in the manual wrong, so I waited until I got home to fire up the
>Amiga and check it.
>
>Also this feature is under the Files tab of pref's, not the General tab
>as
>implied here."

Thanks! Fixed it.

> *** Exploring PgS/Opening a Document / Font substitution ***
>This problem, reported earlier, still exists -

Problem may be to strong of a word Smile

>""It may be just me but I'd like to see a difference between the action
>and the object of the action. I realize that this manual is presented
>the same way as the Release 3 manual, and this point must have been
>discussed before with Michael Loader et all. The problem I'm pointing
>out is particularly obvious in the font substitution paragraph at the
>top of page 8
>"Select Remember to save this substitution for future documents. Select
>Display As instead of Convert To if you don't want to permanently
>change the font name in the document. When you are finished, click
>Done."
>
>I'd like to see the object of the action highlighted by bolding or changing
>the font size/type/italicise. For this email example I'm going to enclose
>in single quotes.
>"Select 'Remember to save this substitution for future documents'. Select
>'Display As' instead of 'Convert To' if you don't want to permanently
>change the font name in the document. When you are finished, click 'Done'."
>I think it would help the understandability.""

That would be a major load of work, and I'm not so sure it is really all
that necessary. Maybe I'll do up a section of the online help and see what
it looks like. So, pick a file for me that you think would help your case
and I'll convert it.

> *** Exploring PgS/Opening a Document / Appending a document ***
>
>The sub subsection "Appending a document" should be raised one level,
>and have the same font size as "Opening a Document" and "Saving a
>Document"

I disagree. Appending is a form of open.

> *** Exploring PgS/ The PageStream Screen/ Toolbox ***
>
>The Toolbox descriptions have some ambiguities:-
>In the first paragraph it would be good to note that the flyout tools
>happen on the Amiga/Mac(?), while on Windows they are rotated through.

Ok. Noted!

>There is no consistency in the way the groups are indicated. Some groups
>(Column, Box, Ellipse & Polygon) are clearly shown, where others are
>not. I would suggest that the icons for the object group be collected
>and placed in a line above the descriptions. The next lines (as they are
>now, with their icons) be indented by one tab and shown as they are now.
>The Path drawing group, the Pen and the Freehand & Grid group, the Grid
>and the Table, should also be treated the same way.

OK, fixed it up some.

>The Table icon and description are missing.

Added (plus lasso and note tool!)


> *** Using Objects/ How to move objects ***
>
>In this section it would be nice to add a note about moving very small
>objects. - At the time the object is selected, if the mouse button is
>held down, the object can be moved, but if the button is released and
>then clicked again on an already selected object to start the move, you
>will more-than-likely get a sizing handle and the object will be sized.

Ok. I put something in there. I'm still not sure object nudging is
documented anywhere...

>*** Using Objects/ How to resize objects/ 3. Position the mouse
>pointer. ***
>
>"Resizing an object usually changes its aspect ratio (the ratio of the
>horizontal to vertical size). To resize an object proportionally, hold
>down a
>Shift key while you drag the mouse."
>
>This paragraph doesn't mention the aspect ratio icon in the Edit
>palette, and the fact that if the icon is set, holding down the Shift
>key will allow the aspect ratio to change during the sizing action.

Thanks. References made there and in the edit palette proportional scale
documentation (and cross-linked).


I welcome additional feedback like this!

>- - - - - - - - -
>
>Peter Martin
>pjmartin@magma.ca


Deron Kazmaier - support@grasshopperllc.com
Grasshopper LLC Publishing -http://www.grasshopperllc.com
PageStream
DTP for Amiga, Linux, Macintosh, and Windows

2002-11-02 10:58:43 CT #3
Peter Martin
From: Canada
Registered: 2006-04-15
Posts: 112

Hi Deron:

> > *** Exploring PgS/Opening a Document / Font substitution ***
> >This problem, reported earlier, still exists -
>
> Problem may be to strong of a word Smile

Point taken.
>
> >""It may be just me but I'd like to see a difference between the
> action
> >and the object of the action. I realize that this manual is presented
> >the same way as the Release 3 manual, and this point must have been
> >discussed before with Michael Loader et all. The problem I'm pointing
> >out is particularly obvious in the font substitution paragraph at the
> >top of page 8
> >"Select Remember to save this substitution for future documents.
> Select
> >Display As instead of Convert To if you don't want to permanently
> >change the font name in the document. When you are finished, click
> >Done."
> >
> >I'd like to see the object of the action highlighted by bolding or
> changing
> >the font size/type/italicise. For this email example I'm going to
> enclose
> >in single quotes.
> >"Select 'Remember to save this substitution for future documents'.
> Select
> >'Display As' instead of 'Convert To' if you don't want to permanently
> >change the font name in the document. When you are finished, click
> 'Done'."
> >I think it would help the understandability.""
>
> That would be a major load of work, and I'm not so sure it is really
> all
> that necessary. Maybe I'll do up a section of the online help and see
> what
> it looks like. So, pick a file for me that you think would help your
> case
> and I'll convert it.
>
I agree that it would be a major work load, but once it is finished
would be a major asset. I envision that you would select each item and
assign a special style tag to them. This would permit format changing
the whole document as your fancy moves. Also you would be able to attach
an index tag to the style, and all of these entries would be ready for
the index. In HTML it would probably mean that the index would be links
to each entry of that word. PgS's manuals have always had a very
inadequate index. I have always considered the index to be far more
important than the table of content.

More coming.

Peter Martin

Sign in to add a comment Pages: 1
Index » PageStream Support » Documentation » Corrections for the HTML manual PgS 4.1

Sign in to add a comment.