On Friday, April 17, 2015 1:18 PM Thiago Macieira wrote: > > Hello Junmo > > The web team can update the documents, provided we are given the new > content. > Please don't expect the web team to create the content. > > A 40-page document will not be read. The guides should be a handful of > pages at most, preferable less than 3. If you have between 3 and 15, you > should make a tutorial. More than that, please write a book (we can talk to > O'Reilly about publishing it). I'm not including environment setup guides in > this. > > 4) I believe Bill Dieter and Pat's team had generated API docs before, so we > should have the infrastructure. I am not privy to details here, but I'm > trying to > find out.
Hi Thiago, Mike Shaver handled everything that got posted to the Drupal site. There are now several different Doxyfiles and JavaDoc, too. I am not sure all the things that are intended to be published. Could someone add a "scons doc" target (or at least reply with all the things that should get built)? If so, I can configure Jenkins to build docs using the scons target, and work with Linux Foundation to archive them in a publicly visible place. Then when it comes time to release, you can just copy the release version to iotivity.org, and the archived versions will be available for whoever wants the bleeding edge docs. Thanks, Bill.
