openerp-community team mailing list archive

[Raphael Valyi <rvalyi@xxxxxxxxx>]

Hello Stéphane,

well I also created a gem extension of Gollum, the Wiki originated from
Github that is able to connect to any Odoo via JSON-RPC and also has page
inheritance just like Odoo. Basically a first extension makes it possible
to use Liquid (the templating language from Shopify or LocomotiveCMS) in
Gollum and then you can use erpify which plugs Ooor to Liquid in less than
100 lines of code.
https://github.com/akretion/liquid_gollum/blob/master/lib/liquid_gollum.rb

I feel reusing Liquid and Gollum is much less reinventing the wheel than
reinventing that web-framework in Odoo we all the scalability, security and
business model issues it carries. It may not be important for documention
but if  it fails to become sustainable because of these issues, you will
eat the consequences too.
An example of a great open source project running Gollum is Freeradius:
http://wiki.freeradius.org/Home

If you are interested in collaborating feel free to contact us or submit
your PR.

Regards.

-- 
Raphaël Valyi
Founder and consultant
http://twitter.com/rvalyi <http://twitter.com/#!/rvalyi>
+55 21 3942-2434
www.akretion.com




On Fri, Aug 1, 2014 at 10:13 AM, Bidoul, Stéphane <stephane.bidoul@xxxxxxxxx
> wrote:

> Hello,
>
> +1 for rst/sphinx/readthedocs for technical documentation.
>
> Regarding functional documentation, we are investigating a way to use the
> v8 website editor to create contextual functional documentation that the
> users would be able to maintain themselves. We envision the possibility to
> let users add documentation pages linked to screens / wizards, as well as
> non contextual introductory documentation.
>
> The system would benefit from the native web page editor and translation
> mechanism of odoo to provide a end-user friendly way to contribute modular
> documentation.
>
> What are your thoughts about this?
> Are there similar initiatives underway?
>
> Best regards,
>
> -sbi
>
>
>
>
> On Tue, Jun 17, 2014 at 5:41 AM, David Arnold - El Alemán <
> david@xxxxxxxxxxx> wrote:
>
>> *Hi OpenERP SA*
>>
>> I'd like to draw your attention on readthedocs.org for a possibility of
>> a very clean and fully git-integrated "tool" for documentation.
>>
>> If you haven't already evaluated, I would kindly recommend to have a
>> quick look at it for V8 docs.
>>
>> I like about readthedocs.org that it is very clean, it encurages
>> updating on git, has cool language and version features.
>> But the main thing is, i think there can't be anything more intuitive and
>> optimized for displaying documentation.
>>
>> Always worring a bit about usability & elegance,
>>
>> *Thank you & best*
>>
>> David Arnold
>>
>>
>> ----------------------
>> *David Arnold B.A. HSG*
>> *Gerente*
>>
>> +57 315 304 1368
>> david@xxxxxxxxxxx
>> www.elaleman.co
>>
>> ​El Alemán S.A.S, Carrera 13 # 93 - 40 P4, Bogotá D.C, Colombia
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~openerp-community
>> Post to     : openerp-community@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~openerp-community
>> More help   : https://help.launchpad.net/ListHelp
>>
>>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openerp-community
> Post to     : openerp-community@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openerp-community
> More help   : https://help.launchpad.net/ListHelp
>
>