Hello Karl, On Saturday 14 February 2009 10:42, Karl Weber wrote: > (1) The Getting Started section describes how to use the NetBeans IDE. I > already dared to add a corresponding description about the Eclipse IDE.
there is already a Wiki page, so one may just add a link to it > (3) All headings in the DevGuide start at level 3, i.e., they are given as > === Heading ===. The headings of other documents of the OOo Wiki start with > level 1 or 2, respectively . I think the text is much easier to read if the > headings start out at level 1. I didn't find any recommendations about > headings in the style guide. > > Although it might not be the proper way to do it, I could move all headings > two levels up while reading the DevGuide. please DO NOT touch this, at least until you get a positive answer from Clayton (sure on Monday); I guess he has tools that rely on this structure to work, so may brake everything. >(5) The DevGuide mentions different example programs, e.g., > >> FirstConnection.java. I cannot find these example programs anywhere. The >> DevGuide only shows some excerpts. Where are these example programs? I >> think, one should include complete and runnable programs into the >> DevGuide. Are there any guidelines about how to do this -- or why this is >> verboten? > >O.K. in the meantime I noticed, that the source code files ship with the SDK >and are located at <SDK_HOME>/examples/DevelopersGuide/. > >Is there a way to browse the source code files (of the examples) in the cvs > / svn repository on-line? I have answered this on your mail to d...@openoffice.org. > If yes, one could easily add appropriate links to > the DevGuide Wiki. Not sure if this is a good idea. All Java examples on the SDK are being ported to NetBeans projects by myself http://api.openoffice.org/source/browse/api/examples/java/netbeans/ right now only the ones with UNO components are ported and work. I don't know what plans has Jürgen Schmidt with the Java SDK examples, but IMHO once I finish my work (I hope for April) there is no sense to keep the SDK Java examples because they are *very* unmantained, and some of them have serious issues (just an example http://api.openoffice.org/servlets/ReadMsg?listName=dev&msgNo=18860); the NB projects, on the other side, are very easy to maintain (and I commit myself to do the job), easy for API user to contribute if they find issues, etc. I first thought about submiting issues against the SDK examples for every error I found and every enhancenment I make, but that would be too much overwork for me. > (6) One can also find a version of the DevGuide at the link > > http://api.openoffice.org/docs/DevelopersGuide/DevelopersGuide.xhtml > > How is this document related to the Wiki? this is the old version that used to ship with the SDK. Now it has been moved to the Wiki and isn't mantained anymore. So now the "official" Developer's Guide is the one on the Wiki. Regards -- Ariel Constenla-Haile La Plata, Argentina "Aus der Kriegsschule des Lebens - Was mich nicht umbringt, macht mich härter." Nietzsche Götzendämmerung, Sprüche und Pfeile, 8. --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org For additional commands, e-mail: dev-h...@documentation.openoffice.org
