James Gosling: on the Java Road
Sunday October 15, 2006
My spare-time fun hacking project for the past couple of months has been a web site for community tranlation of documentation.
It's currently live at
doc.java.sun.com.
When you first look at it, you see what looks like the output of javadoc, which is roughly what it is:
javadoc run inside a servlet container.
You can choose which language to view the documentation in - right now, there's very little
that has actually been translated.
Take a look at an example page
to see what's possible (I'd like to apologize in advance to French readers: my French is very poor, so I used Google's language tools
to do a few translations). The little green squares indicate a successfully located translation, red squares indicate failure.
You can volunteer to translate some phrases. And there can be multiple translations of a phrase available: there's a voting mechanism
for other users to pick which version they like the best.
All of the source is available under the GPL license at docweb.dev.java.net. Please use the forum to discuss DocWeb, and file bug reports and RFEs on the issue tracker.
For now, it really is just an experiment. I'll try to keep it somewhat stable, but it is under active development, and it isn't set up yet for
really huge scale.
Permalink
Comments [11]
Comments are closed for this entry.
Posted by Geza Simon on October 16, 2006 at 12:23 AM PDT #
Posted by GB on October 16, 2006 at 05:03 AM PDT #
This looks cool; I commented a while back that nothing makes you think so carefully about your own language as translation to another language. Is there any mechanism built-in to request clarification of the original English docs when a translator runs into an ambiguous or poorly specified API? It would be great if this could be used as a way to improve the original English version too.
Also, it would be good to add some distinct shapes to the status icons, as an aid to those with red-green color blindness.
Posted by erickson on October 16, 2006 at 12:14 PM PDT #
Posted by Hugues Ferland on October 17, 2006 at 10:05 AM PDT #
Posted by Hugues Ferland on October 17, 2006 at 10:11 AM PDT #
Posted by Deviant Abstraction on October 17, 2006 at 02:33 PM PDT #
Posted by francisco lavin on October 17, 2006 at 06:23 PM PDT #
The Duke logo is really well thought out and delivered.
Posted by Mayuresh Kathe on October 18, 2006 at 06:25 AM PDT #
Posted by Kristin Thomas on October 18, 2006 at 08:56 AM PDT #
Posted by IUSR on October 21, 2006 at 02:29 AM PDT #
Posted by IUSR on October 21, 2006 at 02:46 AM PDT #