The new version is ready, several updates are included follow the feedback to the first version. ODF Format: https://svn.apache.org/repos/asf/incubator/odf/documents/cookbook-2012-02-21.odt PDF Format: https://svn.apache.org/repos/asf/incubator/odf/documents/cookbook-2012-02-21.pdf
We will supply a instruction on how volunteers can add new content. Both the cookbook and cookbook generator code will be include in the second or third release. 2012/2/15 Rob Weir <[email protected]> > 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 > -- -Devin
