Hi Thiago,
Thank you for response. 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. ? [June] Sure, I will send the list of release features to you as word file. Maybe I can gather the items from Intel, but it was difficult as I experienced. ? I think Pat will directly provide it to you. 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 similar, someone from Samsung will send the package of programmer?s guides. Is it ok? ? 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). 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 -----Original Message----- From: Thiago Macieira [mailto:thiago.macie...@intel.com] Sent: Friday, May 22, 2015 12:42 PM To: ???(June Yong Young); '???' Cc: junmo2.yang at samsung.com; 'Dieter, William R'; iotivity-dev at lists.iotivity.org Subject: Re: [dev] web-site and related documents for V0.9.1 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: <mailto:iotivity-dev-bounces at lists.iotivity.org> > iotivity-dev-bounces at lists.iotivity.org [mailto:iotivity-dev- > <mailto:bounces at lists.iotivity.org> bounces at lists.iotivity.org] On > Behalf Of ??? > Sent: Wednesday, April 22, 2015 10:29 PM > To: Dieter, William R; Macieira, Thiago > Cc: <mailto:iotivity-dev at lists.iotivity.org> 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< <mailto:william.r.dieter at intel.com> > 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: <mailto:junmo2.yang at samsung.com> > junmo2.yang at samsung.com > > > > > > > > <http://ext.samsung.net/mailcheck/SeenTimeChecker?do=deb3de73a46b1d55b > e1998f > b91a26a16335c133e7211e6ac2ddbb306ad6a22d54e60fcf6aeb61df594c3b6ddffd76 > 13bcb > 2 38d00164b0be48eeb9bec5ad9c75d326bbdfb2ea96a2fcf878f9a26ce15a0> -- Thiago Macieira - thiago.macieira (AT) intel.com Software Architect - Intel Open Source Technology Center -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.iotivity.org/pipermail/iotivity-dev/attachments/20150522/366ecd5e/attachment.html>
