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 ...


My 2cents



-- 
 mailto:philippe.coval at eurogiciel.fr  --  gpg:0x467094BC
 xmpp:philippe.coval.pro at gmail.com
 https://dockr.eurogiciel.fr/blogs/embedded/author/pcl/
                                                                       .

Reply via email to