Java Help - Where does one report error in Sun's online documentation?

Author

Where does one report error in Sun's online documentation?

Oliver Wong

2006-05-30, 7:11 pm

I was reading the tutorial for editor panes at
http://java.sun.com/docs/books/tuto...editorpane.html
and had trouble understanding the sentence that reads "Instead, the program
would use a text pane to save out a document, which would then be used to
initialize the text pane." I'm guessing this is some sort of error; perhaps
the first "text pane" should be "editor pane". Anyway, I scrolled to the
bottom of the page and clicked on the "Feedback Form" link which takes me to
http://developers.sun.com/contact/tutorial_feedback.jsp

There's a form there that I filled out and clicked submit. Shortly
thereafter, I get the following e-mail:

<quote>
Your message did not reach some or all of the intended recipients.

Subject: Tutorial Feedback
Sent: 5/30/2006 3:11 PM

The following recipient(s) could not be reached:

SDN_tutorial_feedback@sun.com on 5/30/2006 3:11 PM
The e-mail account does not exist at the organization this
message was sent to. Check the e-mail address, or contact the recipient
directly to find out the correct address.The MTS-ID of the original message
is:0J0300K0AELYRW00@brm-avmta-1.central.sun.com
<brm-avmta-1.central.sun.com (tcp-daemon) #5.1.1 smtp;550 5.1.1
<@sunmail1brm.central.sun.com:SDN_tutorial_feedback@sun.com>... User
unknown>
</quote>

So I presume this means that my feedback has been lost forever.

Any ideas where, or to whom, I would report these problems to?

- Oliver

Andrey Kuznetsov

2006-05-30, 7:11 pm

Oliver,

> I was reading the tutorial for editor panes at
> http://java.sun.com/docs/books/tuto...editorpane.html
> and had trouble understanding the sentence that reads "Instead, the
> program would use a text pane to save out a document, which would then be
> used to initialize the text pane." I'm guessing this is some sort of
> error; perhaps the first "text pane" should be "editor pane". Anyway, I
> scrolled to the bottom of the page and clicked on the "Feedback Form" link
> which takes me to http://developers.sun.com/contact/tutorial_feedback.jsp
>
> There's a form there that I filled out and clicked submit. Shortly
> thereafter, I get the following e-mail:
>
> <quote>
> Your message did not reach some or all of the intended recipients.

<snip quote>

> So I presume this means that my feedback has been lost forever.
>
> Any ideas where, or to whom, I would report these problems to?
>

I have seen in a bug database reports about errors in documentation.

Andrey

--
http://uio.imagero.com Unified I/O for Java
http://reader.imagero.com Java image reader
http://jgui.imagero.com Java GUI components and utilities

Oliver Wong

2006-05-30, 7:11 pm

"Andrey Kuznetsov" <spam0@imagero.com.invalid> wrote in message
news:e5idrh$kqv$1@online.de...
> Oliver,
>
>
> <snip quote>
>
>
> I have seen in a bug database reports about errors in documentation.

I went to http://bugs.sun.com/ but the categories there don't seem to
include "Documentation". There isn't even a catch-all "others" category
(they have something called "------OTHER-----", but it's a seperator, and
not an actual selectable item).

- Oliver

Bjorn Abelli

2006-05-30, 7:11 pm

"Oliver Wong" wrotw...

> I went to http://bugs.sun.com/ but the categories there don't seem to
> include "Documentation". There isn't even a catch-all "others" category
> (they have something called "------OTHER-----", but it's a seperator, and
> not an actual selectable item).

If you choose "Java 2 Platform Standard Edition JRE/JDK" as the
Product/Category, you can choose "JDK/JRE documentation, API, tutorials
(doc)" as Subcategory.

That would probably be what you're looking for?

// Bjorn A

Inviato da X-Privat.Org - Registrazione gratuita http://www.x-privat.org/join.php

VisionSet

2006-05-30, 7:11 pm

"Oliver Wong" <owong@castortech.com> wrote in message
news:0W0fg.14$I61.4@clgrps13...

> Any ideas where, or to whom, I would report these problems to?
>

I don't understand why they don't run an xml style validator over it before
release. Catch all those badly formed <code></code> tags which obliterate
the font.

--
Mike W

Oliver Wong

2006-05-31, 7:12 pm

"Bjorn Abelli" <bjorn_abelli@DoNotSpam.hotmail.com> wrote in message
news:447cc298$1_3@x-privat.org...
>
> "Oliver Wong" wrotw...
>
>
> If you choose "Java 2 Platform Standard Edition JRE/JDK" as the
> Product/Category, you can choose "JDK/JRE documentation, API, tutorials
> (doc)" as Subcategory.
>
> That would probably be what you're looking for?

Yes, that's it. Thank you. I've filed the 2 bugs: The textpane/editor
pane one, and the broken e-mail address.

- Oliver

Sponsored Links