On Wed, Feb 15, 2012 at 3:01 AM, Devin Han <[email protected]> wrote: > Hi all, > > After collected feedback from users and analyse the report from Google > Analytics, we found that Simple API Cookbook is a very important way for > users to learn ODF Toolkit. You can see the online cookbook page is the > second access port of our website, except the index page[1]. > > In order to help users reference this cookbook easily, we decide to supply > an offline version. So, I take nearly two weeks to complete this work. >
Wow. This is so cool ! Some comments: 1) The code snippets should probably be in a mono-space font like Courier or Courier New. That helps distinguish it from the normal text of the document. 2) The footer currently says "@2011,The Apache Software Foundation". It should be either "(C) 2011,The Apache Software Foundation"or even better "© 2011,The Apache Software Foundation" The special copyright symbol is U+00A9. In HTML it would be © or © 3) Maybe we include the cookbook in our doc package, along with the JavaDoc? (That would mean that we also include the cookbook source in our source release). This might make sense if we think the cookbook is tied to a specific ODF Toolkit release. This will probably be true once we rename the packages. The new cookbook won't work for the old 0.5 release. 4) It might be good to have some instructions on how volunteers can add new cookbook samples. -Rob > As you know our cookbook is generated from java code and comment in HTML > format, now I modify the program and make it can generate ODF format with > the help of Simple API and ODFDOM. You can get this beautiful document > here[2]. I also convert it to PDF format using Symphony[3]. > > This is a preview version. The formal verion can be download from our > website later. > > So, now enjoy it and give me your feedback ;) > > [1] > https://svn.apache.org/repos/asf/incubator/odf/documents/visitor%20flow.png. > [2] > https://svn.apache.org/repos/asf/incubator/odf/documents/cookbook-2012-02-15.odt > [3] > https://svn.apache.org/repos/asf/incubator/odf/documents/cookbook-2012-02-15.pdf > > -- > -Devin
