Hi June Release notes should come from the Release and QA team. They're the ones who know what isn't working at the time of release and what to watch out for. If we get those notes, I can pass to some technical writers to polish the text.
Programmer's guides should come from technical writers assigned to IoTivity. Since we have none, that falls back on the developers. I don't think there isn't much difference from previous releases, so it shouldn't be too difficult to update for this release. Once there's a more or less finished text, I can ask one of the technical writers at Intel to take a look. As for the release announcement itself, Myungjae and I can draft that, if we get the list of features and important changes compared to the last release (pointing to JIRA tasks is enough). I hope this helps. On Friday 22 May 2015 10:36:32 ??? wrote: > Thiago, Myungjae, > > > > I?d like to revisit this issue since we are about to release 0.9.1. > > Who is taking care of actual writing release note & programmer?s guide in > Wiki? > > I heard from Junmo that those documents are supposed to be moved to WiKi > page, then who is making the basic form in WiKi? > > (Although contents themselves will be written or something else by > developers) > > > > Regards > > June > > > > June Yong Young > OIC Open Sourece WG Project Planning & Requirement TG Chair > > IoTivity Release Function Lead > > > Samsung Electronics Co.,Ltd. > > Software R&D Center, IoT Solution Lab. | Web & Convergence Team > > Principal Engineer > > T: +82-31-301-6107, M: +82-10-9530-6107 > > E-mail :juney at samsung.com > > > > From: iotivity-dev-bounces at lists.iotivity.org [mailto:iotivity-dev- > bounces at lists.iotivity.org] On Behalf Of ??? > Sent: Wednesday, April 22, 2015 10:29 PM > To: Dieter, William R; Macieira, Thiago > Cc: iotivity-dev at lists.iotivity.org; Shaver, Michael R; ??? > Subject: Re: [dev] web-site and related documents for V0.9.1 > > > > Dear All, > > > > Now, It is almost time for v0.9.1 release. > > Anyone knows who will generate API Docs both for C/C++ and for Andorid? > > Both sould include everything in master branch at this time. > > (Current API docs which is on IoTivity web site only includes the base > module, except primitive service.) > > Please raise your hand who is going to take care of API Docs. > > > > BR, > > - Junmo > > > > > > ------- Original Message ------- > > Sender : Dieter, William R<william.r.dieter at intel.com> > > Date : 2015-04-20 10:45 (GMT+09:00) > > Title : RE: [dev] web-site and related documents for V0.9.1 > > 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. > > > > > > ??? (Junmo Yang, Ph.D.) > > Principal Engineer > > IoT Solution Lab./Web & Convergence Team > > Software R&D Center, Samsung Electronics Co.,Ltd. > > Mobile: +82-10-7260-7032 E-mail: junmo2.yang at samsung.com > > > > > > > > <http://ext.samsung.net/mailcheck/SeenTimeChecker?do=deb3de73a46b1d55be1998f > b91a26a16335c133e7211e6ac2ddbb306ad6a22d54e60fcf6aeb61df594c3b6ddffd7613bcb > 2 38d00164b0be48eeb9bec5ad9c75d326bbdfb2ea96a2fcf878f9a26ce15a0> -- Thiago Macieira - thiago.macieira (AT) intel.com Software Architect - Intel Open Source Technology Center
