Hi Gregg and IoTivity dev list, I changed the subject header since there’s been a few DITA-specific threads that have followed since Gregg’s inquiry directed at me yesterday and I didn’t want to interrupt that discussion.
Gregg and others - apologies for any confusion I have created re: Tech Docs. We are seeking volunteers to help improve the IoTivity website documentation. If I haven’t made a formal invitation to this list, consider it done now. We don’t have a plan yet but for sure, we want to clean up the IoTivity wiki -- so volunteers can let us know if there’s a specific wiki area they want to tackle. To address Gregg’s other question, solicitations for Tech Docs volunteers were made to the OCF Open Source WG and the OCF Tools Task Group – the Tools TG being the folks that do things like the Getting Started Tutorial for the OCF SDK, etc. The OCF Open Source WG handles code readiness and releases and the administration of the IoTivity project – for example, managing contracts to host the IoTivity project, to do QA on the IoTivity code and recently – a proposal to fund a full time Tech Docs person to help with the OCF developer experience … most of which – if the OCF BoD approves it -- would be focused on improving the IoTivity website / documentation. Does that answer your question? I’m not sure what makes an activity to improve IoTivity “official.” David Kinder has only recently joined as a part time Tech Docs volunteer and spent most of his first few months helping the OCF Tools TG with the OCF SDK – which of course is based upon IoTivity. And yes, he has recently joined this list. David can make changes to the website so if we get volunteers, we are positioned to make progress. Let me know if you have further questions, Margaret From: Gregg Reynolds [mailto:[email protected]] Sent: Wednesday, January 10, 2018 4:40 PM To: LaBrecque, Margaret <[email protected]> Cc: Arthur Barros Lapprand <[email protected]>; iotivity-dev <[email protected]>; Kinder, David B <[email protected]> Subject: RE: [dev] new documentation project On Jan 10, 2018 6:25 PM, "Gregg Reynolds" <[email protected]<mailto:[email protected]>> wrote: On Jan 10, 2018 5:45 PM, "LaBrecque, Margaret" <[email protected]<mailto:[email protected]>> wrote: Hi Arthur, We’d love to take you up on interest in contributing documentation! I’ll ask David Kinder – a part time Tech Docs volunteer from the Intel team – to add you to our weekly Tech Docs meeting. (I’ve copied David on this email since I don’t think he’s on the IoTivity dev list at present) Hi Margaret, Don't take this personally, but wtf does "our" weekly tech docs meeting mean? Who is "we" when you say "We'd love to take you up ... ". Intel? OCF? Iotivity? You have mentioned such meetings several times and threatened to invite me a few times, but I have never seen hide nor hair of it on this list, which is the primary channel of Iotivity communications AFAIK. If it is a secret corporate initiative I do not see how it helps OCF/Iotivity. Furthermore I have not noticed the slightest improvement in Iotivity documentation for many months. And you're copying an alleged doc guy who is not even subscribed to this list? That does not inspire confidence. I'll ask you the same question that was asked of me on another thread: is whatever you are doing an Official Iotivity thing, or not? Thanks Gregg
_______________________________________________ iotivity-dev mailing list [email protected] https://lists.iotivity.org/mailman/listinfo/iotivity-dev
