> -----Original Message----- > From: iotivity-dev-bounces at lists.iotivity.org [mailto:iotivity-dev- > bounces at lists.iotivity.org] On Behalf Of Philippe Coval > Sent: Thursday, February 26, 2015 7:23 PM > To: Macieira, Thiago > Cc: iotivity-dev at lists.iotivity.org > Subject: Re: [dev] How to update docs on iotivity.org > > On Thu, Feb 26, 2015 at 6:55 PM, Thiago Macieira > <thiago.macieira at intel.com> wrote: > > On Thursday 26 February 2015 06:33:18 VanCutsem, Geoffroy wrote: > >> Hi folks, > >> > >> What is the process to get some documentation from the main website > updated > >> (where needed)? > >> > >> I was looking at the Getting Started page for Arduino [1] and there are > >> minor corrections and adjustments that we should make (e.g. avr-gcc > version > >> for the Arduino SDK, use of scons instead of make since iotivity 0.9). I > >> was thinking about filing a JIRA request but not sure if this is the > >> preferred method. > >> > >> [1] https://www.iotivity.org/documentation/arduino/getting-started > > > > Hi Geoff > > > > For updating the main website, there are two ways: > > > > 1) for infrequent contributions, send to someone from the web team (part > of > > the Community & Events Function) > > > > 2) for more frequent activity, you should simply get edit rights. For that, > > either create a ticket on our JIRA against the infrastructure or send an > email > > to iotivity-helpdesk at rt.linuxfoundation.org. > > I have no idea on how is managed the documentation of LF hosted projects. > > but I think that some parts could be done using static generators from > text files (markdown, org mode or more advanced tools like > http://getnikola.com/ ). > > Then the sources of pages could be hosted as git tree and open to > community edit through gerrit ? > > This is just a suggestion but I tend to bet that that this effort > could be shared and it's good to track the differences over time ...
+1 on Philippe's proposal. Cheers, Geoffroy ----------------------------------------------- Intel Corporation NV/SA Kings Square, Veldkant 31 2550 Kontich RPM (Bruxelles) 0415.497.718. Citibank, Brussels, account 570/1031255/09
