| Where do I report documentation errors? [message #296001] |
Tue, 13 December 2005 15:34  |
Eclipse User |
|
|
|
Originally posted by: no.offline.contact.please.nospam.com
I've found a rather odd phrasing in the Help for Eclipse 3.1.1. The title of
the page is "Message Bundles in 3.1". The first paragraph starts:
"Standard Java ResourceBundles have quite inefficient space characteristics.
Since a running Eclipse tends to have many externalized messages we have
implemented a new message bundle _story_ [emphasis added] to be used in
Eclipse...."
The word 'story' doesn't feel right although I'm at a loss to know what
should be in its place. (If anyone knows, I'd be interesting in hearing what
word should replace 'story'.)
Assuming that this really is an error that slipped past the proofreaders,
how do I bring this to the attention of the technical writers so that it can
be fixed in some future version of Eclipse? I assume that there is an
appropriate way to report things like this....
--
Rhino
|
|
|
|
| Re: Where do I report documentation errors? [message #296007 is a reply to message #296001] |
Tue, 13 December 2005 16:24  |
| Eclipse User |
|
|
|
implementation? Nope, they say "implemented" 5 words prior, so that
won't work. capability??
bugs.eclipse.org => Bug Reports => Report a new bug => Eclipse =>
Platform, then choose Doc as the Component.
I think at the first link you'll need to sign up for your own bugzilla ID.
I don't find the wording that strange, but if you do, then certainly
report it. My experience is that if someone has a problem with
something, others probably will too. On the other hand, I don't know
that I've ever pleased *everybody* with any decision I've made.
I guess it's just a wishy-washy kind of day.
--
RDS
Rhino wrote:
> I've found a rather odd phrasing in the Help for Eclipse 3.1.1. The title of
> the page is "Message Bundles in 3.1". The first paragraph starts:
>
> "Standard Java ResourceBundles have quite inefficient space characteristics.
> Since a running Eclipse tends to have many externalized messages we have
> implemented a new message bundle _story_ [emphasis added] to be used in
> Eclipse...."
>
> The word 'story' doesn't feel right although I'm at a loss to know what
> should be in its place. (If anyone knows, I'd be interesting in hearing what
> word should replace 'story'.)
>
> Assuming that this really is an error that slipped past the proofreaders,
> how do I bring this to the attention of the technical writers so that it can
> be fixed in some future version of Eclipse? I assume that there is an
> appropriate way to report things like this....
>
|
|
|
| Re: Where do I report documentation errors? [message #296017 is a reply to message #296007] |
Tue, 13 December 2005 17:41 |
| Eclipse User |
|
|
|
Originally posted by: no.offline.contact.please.nospam.com
Thank you both for pointing me in the right direction. I've filed a report
with Bugzilla.
Personally, I'm inclined to think Sunil is probably right; it wouldn't be
that hard to misspell 'strategy' as 'story' - would it? Hmm, guess I'm
feeling a little wishy-washy today, too :-)
Rhino
"Randy D. Smith" <randy.d.smith@intel.com> wrote in message
news:dnne6d$gra$1@news.eclipse.org...
> implementation? Nope, they say "implemented" 5 words prior, so that won't
> work. capability??
>
> bugs.eclipse.org => Bug Reports => Report a new bug => Eclipse =>
> Platform, then choose Doc as the Component.
>
> I think at the first link you'll need to sign up for your own bugzilla ID.
>
> I don't find the wording that strange, but if you do, then certainly
> report it. My experience is that if someone has a problem with something,
> others probably will too. On the other hand, I don't know that I've ever
> pleased *everybody* with any decision I've made.
>
> I guess it's just a wishy-washy kind of day.
> --
> RDS
>
>
> Rhino wrote:
>> I've found a rather odd phrasing in the Help for Eclipse 3.1.1. The title
>> of the page is "Message Bundles in 3.1". The first paragraph starts:
>>
>> "Standard Java ResourceBundles have quite inefficient space
>> characteristics. Since a running Eclipse tends to have many externalized
>> messages we have implemented a new message bundle _story_ [emphasis
>> added] to be used in Eclipse...."
>>
>> The word 'story' doesn't feel right although I'm at a loss to know what
>> should be in its place. (If anyone knows, I'd be interesting in hearing
>> what word should replace 'story'.)
>>
>> Assuming that this really is an error that slipped past the proofreaders,
>> how do I bring this to the attention of the technical writers so that it
>> can be fixed in some future version of Eclipse? I assume that there is an
>> appropriate way to report things like this....
>>
|
|
|
| Re: Where do I report documentation errors? [message #296076 is a reply to message #296017] |
Wed, 14 December 2005 13:06 |
| Eclipse User |
|
|
|
Originally posted by: no.offline.contact.please.nospam.com
In case anyone is wondering, the bug report has number 120759; I've already
received notification that the bug is fixed as of Eclipse 3.2 M4! The tech
writer replaced 'story' with 'message bundle system'.
Rhino
"Rhino" <no.offline.contact.please@nospam.com> wrote in message
news:dnnilt$n00$1@news.eclipse.org...
> Thank you both for pointing me in the right direction. I've filed a report
> with Bugzilla.
>
> Personally, I'm inclined to think Sunil is probably right; it wouldn't be
> that hard to misspell 'strategy' as 'story' - would it? Hmm, guess I'm
> feeling a little wishy-washy today, too :-)
>
> Rhino
>
> "Randy D. Smith" <randy.d.smith@intel.com> wrote in message
> news:dnne6d$gra$1@news.eclipse.org...
>> implementation? Nope, they say "implemented" 5 words prior, so that won't
>> work. capability??
>>
>> bugs.eclipse.org => Bug Reports => Report a new bug => Eclipse =>
>> Platform, then choose Doc as the Component.
>>
>> I think at the first link you'll need to sign up for your own bugzilla
>> ID.
>>
>> I don't find the wording that strange, but if you do, then certainly
>> report it. My experience is that if someone has a problem with something,
>> others probably will too. On the other hand, I don't know that I've ever
>> pleased *everybody* with any decision I've made.
>>
>> I guess it's just a wishy-washy kind of day.
>> --
>> RDS
>>
>>
>> Rhino wrote:
>>> I've found a rather odd phrasing in the Help for Eclipse 3.1.1. The
>>> title of the page is "Message Bundles in 3.1". The first paragraph
>>> starts:
>>>
>>> "Standard Java ResourceBundles have quite inefficient space
>>> characteristics. Since a running Eclipse tends to have many externalized
>>> messages we have implemented a new message bundle _story_ [emphasis
>>> added] to be used in Eclipse...."
>>>
>>> The word 'story' doesn't feel right although I'm at a loss to know what
>>> should be in its place. (If anyone knows, I'd be interesting in hearing
>>> what word should replace 'story'.)
>>>
>>> Assuming that this really is an error that slipped past the
>>> proofreaders, how do I bring this to the attention of the technical
>>> writers so that it can be fixed in some future version of Eclipse? I
>>> assume that there is an appropriate way to report things like this....
>>>
>
>
|
|
|
|
|
|
Powered by
FUDForum. Page generated in 0.04591 seconds
Home