206840 - Help documentation needs to be updated for the Mozilla Branding Strategy

Status: RESOLVED WONTFIX

(Documentation Graveyard :: Help Viewer, defect)

Description

[Daniel Wang]

by private e-mail

me > I'm a little bit confused about "mail/news" vs "Messenger".
   > Should we edit mozilla.org docs and online Help to reflect
   > this distinction?
Christ Blizzard > Hmm.  Maybe, yeah.

so... browser -> Navigator, mail & newsgroup -> Messenger

Comment 1

[Ian Oeschger (gone)]

moving stuff over to an outside-the-firewall email for the time being, looking
for people to pick these Help and doc bugs up for me.

Comment 2

[R.J. Keller]

--> me

What did you have in mind, Daniel? I don't think I agree with changing Mail/News
to Messenger.

Comment 3

[Daniel Wang]

check out www.mozilla.org/releases/mozilla1.4/ . Asa uses "Messenger (Mail &
Newsgroups)"

Comment 4

[R.J. Keller]

OK, after reading the branding docs we should have this. Let's wait until the
mailnews portion of bug 95770 is done.

Comment 5

[Ben Bucksch (:BenB)]

Vendors may (and actually do) use slightly or completely different product
names, so you should not hardcode the product names, but use placeholders like
&brandShortName; or &browserBrandName; or &mailnewsBrandName; or similar. With
that, you can aso easily swtich all docs when mozilla.org changes its names.

Changing summary from
"Help documentation needs to be updated for the Mozilla Branding Strategy"
to
"Help documentation should not hardcode product names"

Comment 6

[R.J. Keller]

I don't think that this is what the bug is about, but using a DTD file for the
name will probably be used. That bug will probably be fixed while in the process
of fixing this bug.

Ben: do you know of any DTD file that might contain a &mailnewsBrandName;? I've
only seen &brandShortName;.

Comment 7

[Ben Bucksch (:BenB)]

> do you know of any DTD file that might contain a &mailnewsBrandName;?

Unfortunately not, it should be created. Should I file a bug against Mailnews or
do you want to add it to the help component?

Comment 8

[R.J. Keller]

I'd like one in MailNews, but I'm not sure how the MailNews team would feel
about this. There must be a reason as to why there isn't one there. If there is
a good reason, then I'll add a new DTD file.

Comment 9

[Daniel Wang]

>> do you know of any DTD file that might contain a &mailnewsBrandName;?
>
> Unfortunately not, it should be created. Should I file a bug against Mailnews or
> do you want to add it to the help component?

Ben, you already did bug 84851

-> wontfix until a decision on bug 206838 is reached

Comment 10

[Ben Bucksch (:BenB)]

Thanks for the hint to bug 84851, I totally forgot about it.

Filed bug 232794.