[TRACKER] Firefox Help Documentation changes before the 1.0 release

RESOLVED FIXED in Firefox1.0

Status

P3
normal
RESOLVED FIXED
15 years ago
3 years ago

People

(Reporter: rjkeller, Assigned: jwalden+fxhelp)

Tracking

({late-l10n, meta})

1.0 Branch
Firefox1.0
late-l10n, meta
Dependency tree / graph
Bug Flags:
blocking-aviary1.0PR -

Firefox Tracking Flags

(Not tracked)

Details

(Reporter)

Description

15 years ago
This is a tracker bug for inaccuracies and typos found in the Help documentation
that need to be repaired even though the Help freeze has occured.
(Reporter)

Updated

15 years ago
Status: NEW → ASSIGNED
(Reporter)

Updated

15 years ago
Depends on: 253066, 253068, 253070

Updated

15 years ago
Depends on: 253246

Comment 1

15 years ago
I just checked in a couple of minor updates. There's no bug for them, so please
have a look at this:
http://bonsai.mozilla.org/cvsquery.cgi?treeid=default&branch=&date=explicit&mindate=07%2F27%2F2004+02%3A05&maxdate=07%2F27%2F2004+03%3A24
Flags: blocking-aviary1.0?
OS: Windows XP → All
Hardware: PC → All
Depends on: 253464
(Reporter)

Updated

15 years ago
No longer depends on: 253464
(Reporter)

Updated

15 years ago
Blocks: 253464

Updated

15 years ago
Depends on: 253521
(Assignee)

Updated

15 years ago
Depends on: 253538

Comment 2

15 years ago
The following is based on this cmd pulling the same files you're meaning:
cvs checkout -r AVIARY_1_0_20040515_BRANCH mozilla/components/help/locale

These are all minor points - I didn't think a separate bug was necessary.

Nits:

customization.xhtml
 line 175: "extensions" should be extension

glossary.xhtml
 "email" not "e-mail" in Internet (line 200) and Master Password (line 236)
  (cf "e-mail" in plug-in (line 281)

menu_reference.xhtml
 line 81: missing full-stop

using_firebird.xhtml
 line 77: <p> element begins with an extra unneeded ">"
 lines 277 + 306: reference to "hard drive", not "hard disk"

welcome.xhtml
 lines 87-88: "Firebird" (not -fox) and "Mozilla" - replace with
  &brandShortName; / &vendorShortName;?

Semantics:

firefox_welcome.xhtml
 too many unneeded ' valign="top"' strings in the table
 several headings should be in <th>s, not <td>s?
  (NB - if you change the above, need to add a
    (.noTableBorder) th { text-align: left; }
  rule into the css (.noTableBorder to limit application))
prefs.xhtml
 lines 104-110: inconsistent <p>s and <br/>s

Suggestion:

menu_reference.xhtml
 could <h4> do to be indented, if you're going to use <h2-4> as menu levels?

(Reporter)

Comment 3

15 years ago
(In reply to comment #2)
> The following is based on this cmd pulling the same files you're meaning:
> cvs checkout -r AVIARY_1_0_20040515_BRANCH mozilla/components/help/locale
> 
> These are all minor points - I didn't think a separate bug was necessary.
> 
> Nits:
> 
> customization.xhtml
>  line 175: "extensions" should be extension

done

> 
> glossary.xhtml
>  "email" not "e-mail" in Internet (line 200) and Master Password (line 236)
>   (cf "e-mail" in plug-in (line 281)

No, it should be e-mail ->
http://www.mozilla.org/projects/help-viewer/documentation_language-style.php#terms

> 
> menu_reference.xhtml
>  line 81: missing full-stop

what do you mean by this?

> 
> using_firebird.xhtml
>  line 77: <p> element begins with an extra unneeded ">"

fixed

>  lines 277 + 306: reference to "hard drive", not "hard disk"

I personally would prefer "hard drive" over "hard disk".

> 
> welcome.xhtml
>  lines 87-88: "Firebird" (not -fox) and "Mozilla" - replace with
>   &brandShortName; / &vendorShortName;?

fixed

> 
> Semantics:
> 
> firefox_welcome.xhtml
>  too many unneeded ' valign="top"' strings in the table
>  several headings should be in <th>s, not <td>s?
>   (NB - if you change the above, need to add a
>     (.noTableBorder) th { text-align: left; }
>   rule into the css (.noTableBorder to limit application))

I'll do this one later :).

> prefs.xhtml
>  lines 104-110: inconsistent <p>s and <br/>s

That is done for a reason.

> 
> Suggestion:
> 
> menu_reference.xhtml
>  could <h4> do to be indented, if you're going to use <h2-4> as menu levels?

No, I don't feel that it's necessary, but I understand where you think that. The
paragraph indentation makes the menu reference headings look thrown off. I might
remove that indentation from the CSS.
(Reporter)

Updated

15 years ago
Flags: blocking-aviary1.0PR+
(Reporter)

Comment 4

15 years ago
steffen: Firefox 1.0 PR is the localization freeze, so this bug couldn't
possibly block 1.0.
No longer blocks: 253464
Depends on: 253464, 253657
Flags: blocking-aviary1.0?
(Reporter)

Updated

15 years ago
Depends on: 253705

Comment 5

15 years ago
(In reply to comment #3)
> (In reply to comment #2)
[...]
> > glossary.xhtml
> >  "email" not "e-mail" in Internet (line 200) and Master Password (line 236)
> >   (cf "e-mail" in plug-in (line 281)
> 
> No, it should be e-mail ->

Sorry, that's what I meant - line 200 & 236 have instances of "email", not "e-mail".

> > menu_reference.xhtml
> >  line 81: missing full-stop
> 
> what do you mean by this?

That line is missing a full-stop, compared to all the other lines.
Or is it a UK/US thing?  full-stop == period == "."

> >  lines 277 + 306: reference to "hard drive", not "hard disk"
> 
> I personally would prefer "hard drive" over "hard disk".

hard disk is more used throughout the Help, AFAICT. I don't mind, as long as
it's consistent.
(Reporter)

Comment 6

15 years ago
(In reply to comment #5)
> hard disk is more used throughout the Help, AFAICT. I don't mind, as long as
> it's consistent.

Most users I've met know what a Hard Drive is, but not what a Hard Disk is. I'd
rather use that definition since it's more commonly used (at least in the
end-user world). If you see Hard Disk, then it needs to be changed.
(Reporter)

Updated

15 years ago
Depends on: 249231
(Assignee)

Updated

15 years ago
Depends on: 254727
Assigning a priority for neatness. 
Priority: -- → P3
(Reporter)

Updated

15 years ago
No longer depends on: 253521
(Reporter)

Updated

15 years ago
Blocks: 254982
(Reporter)

Updated

15 years ago
No longer blocks: 254982
Depends on: 254982
(Assignee)

Updated

15 years ago
Depends on: 254752
(Assignee)

Updated

15 years ago
Depends on: 255131
(Assignee)

Updated

15 years ago
Depends on: 255465

Comment 8

15 years ago
need to wrap up these changes in the next few days or risk missing 1.0
localization freeze and final release.  I'm going to -minus this bug and plus
any in the dependence list that seem critical at this point.
Flags: blocking-aviary1.0PR+ → blocking-aviary1.0PR-
(Reporter)

Updated

15 years ago
No longer depends on: 255465

Comment 9

15 years ago
In the cookie section under "Setting Up Cookie-Rules" at "ask me every time" i
miss the note that "Allow sites to set cookies" MUST be activated. Because it's
possible to select "ask me every time" without activating "Allow sites to set
cookies" it will be a problem for beginners and not only.

Updated

15 years ago
Depends on: 255576

Updated

15 years ago
Depends on: 255695

Updated

15 years ago
Depends on: 253555

Updated

15 years ago
Depends on: 254780

Comment 10

15 years ago
I've removed the unused file
mozilla/browser/components/help/locale/en-US/firebird-glossary.rdf from both
branch and trunk. r=rlk via IRC.

However, we have two more unused files:
mozilla/browser/components/help/locale/en-US/glossary.xhtml
mozilla/browser/components/help/locale/en-US/help-toc.rdf
They were copied to mozilla/toolkit/components/help/helpOnHelp/locale/en-US/.
Can I remove these as well?
(Reporter)

Comment 11

15 years ago
(In reply to comment #10)
> I've removed the unused file
> mozilla/browser/components/help/locale/en-US/firebird-glossary.rdf from both
> branch and trunk. r=rlk via IRC.
> 
> However, we have two more unused files:
> mozilla/browser/components/help/locale/en-US/glossary.xhtml
> mozilla/browser/components/help/locale/en-US/help-toc.rdf
> They were copied to mozilla/toolkit/components/help/helpOnHelp/locale/en-US/.
> Can I remove these as well?

yup, burn 'em. r=rlk@trfenv.com on removal of those files.

Comment 12

15 years ago
burned branch and trunk.

Updated

15 years ago
Depends on: 255003
(Reporter)

Updated

15 years ago
No longer depends on: 254982
(Reporter)

Updated

15 years ago
Depends on: 253415
(Assignee)

Updated

15 years ago
Depends on: 256363
(Assignee)

Updated

15 years ago
Depends on: 256364

Updated

15 years ago
Depends on: 256613

Updated

15 years ago
Depends on: 248264

Updated

15 years ago
Depends on: 256661

Updated

15 years ago
Depends on: 256805

Updated

15 years ago
Depends on: 256845
(Reporter)

Updated

15 years ago
Depends on: 256806
(Reporter)

Updated

15 years ago
Depends on: 256905

Updated

15 years ago
Depends on: 256968
(Reporter)

Comment 13

15 years ago
Moving to new Firefox Help owner.
Assignee: rlk → jwalden+fxhelp
Status: ASSIGNED → NEW
(Assignee)

Updated

15 years ago
Depends on: 257274
(Assignee)

Updated

15 years ago
Depends on: 258640
(Assignee)

Updated

15 years ago
Depends on: 258671

Updated

15 years ago
Depends on: 259083

Comment 14

15 years ago
I just landed a patch to change Help image paths to 1.0 and change some
resolutions, see bug 248264 comment 38.
Version: unspecified → 1.0 Branch
(Assignee)

Updated

15 years ago
Depends on: 257007
(Assignee)

Updated

15 years ago
Depends on: 258684

Updated

15 years ago
Depends on: 259481

Updated

15 years ago
Depends on: 260864

Updated

15 years ago
Depends on: 261555

Updated

15 years ago
Depends on: 261749

Updated

15 years ago
Depends on: 262072

Updated

15 years ago
Keywords: late-l10n, meta
Summary: [TRACKER] Firefox Help Documentation changes after Help 1.0 freeze → [TRACKER] Firefox Help Documentation changes before the 1.0 release

Updated

15 years ago
Depends on: 254982

Updated

15 years ago
Depends on: 259883
Depends on: 263547

Updated

15 years ago
Depends on: 263369

Updated

15 years ago
Depends on: 263769
(Assignee)

Updated

15 years ago
Depends on: 263963
(Assignee)

Updated

15 years ago
Depends on: 260050
(Assignee)

Updated

15 years ago
Depends on: 258665

Updated

15 years ago
Depends on: 264317

Updated

15 years ago
Target Milestone: --- → Firefox1.0

Updated

15 years ago
Depends on: 259387
(Assignee)

Updated

15 years ago
Depends on: 263759
(Assignee)

Updated

15 years ago
Depends on: 258076

Updated

15 years ago
Depends on: 264323

Updated

15 years ago
Depends on: 264332
(Assignee)

Comment 15

15 years ago
As an FYI, Help in 1.0mac might have a fix or two (mostly for shortcuts that
might be incorrect and for some menus like Window that don't exist elsewhere),
but it'll be nowhere near the number of changes we've now.

Now, finally, Help for 1.0 is done.
Status: NEW → RESOLVED
Last Resolved: 15 years ago
Resolution: --- → FIXED
Product: Firefox → Firefox Graveyard
You need to log in before you can comment on or make changes to this bug.