Better Layer Documentation

I'm working on a branch to provide better layer documentation. This is the official place for the layer documentation, available from the NetBeans Javadoc landing page:

http://bits.netbeans.org/dev/javadoc/layers.html

And here's my version, constantly in flux, note that I am focusing on good descriptions and examples (and explanations of those examples). Check back to this link every few days and you'll start noticing improvements, hopefully:

http://deadlock.netbeans.org/hudson/job/prototypes-better-layer-docs-187277/javadoc/layers.html

Comments:

Hello Geertjan!
Thanks for your work! It sometimes lacks of information about all features provided by the layer configurations! It's very important that you do!
I want to ask you maybe it will be better to have some hierarchy in one page with all links to the special page, not just as a part of the netbeans platform javadoc. It was very difficult to find needed information page inside javadoc.
For example, I have found these pages accidentally:
http://bits.netbeans.org/dev/javadoc/org-openide-filesystems/org/openide/filesystems/doc-files/HOWTO-MIME.html
http://bits.netbeans.org/dev/javadoc/org-openide-explorer/org/openide/explorer/doc-files/propertyViewCustomization.html
http://bits.netbeans.org/dev/javadoc/org-openide-util/org/openide/util/doc-files/logging.html

and some others.

Posted by Alexander Zdanevich on June 26, 2010 at 07:44 PM PDT #

Re. "special page" - maybe there could be "my-favorites" pages. For example alexander-favorites.html and pepe-favorites.html and jarda-favorites.html. That way everyone will find exactly what one is searching for...

Posted by Jaroslav Tulach on June 27, 2010 at 03:42 PM PDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

Geertjan Wielenga (@geertjanw) is a Principal Product Manager in the Oracle Developer Tools group living & working in Amsterdam. He is a Java technology enthusiast, evangelist, trainer, speaker, and writer. He blogs here daily.

The focus of this blog is mostly on NetBeans (a development tool primarily for Java programmers), with an occasional reference to NetBeans, and sometimes diverging to topics relating to NetBeans. And then there are days when NetBeans is mentioned, just for a change.

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
12
13
14
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today