[Erp5-users] ERP5 HandBook plans and progress

[Jean-Paul Smets]

Hi,

We share same goals: "minimize repetition and give place to contribute".
 
As we discussed a year ago, I think HB must be moved to ERP5 wiki and
written in such way that the introductory part is kept as small as
possible with details handled through the How To part of the wiki and
links. I feel it is the only way to keep the maintenance effort low
enough and make sure all content is up to date. I hope to see some
progress in that direction soon.

Othewise, I fear that we get many questions due to outdated content
without having enough resources (ie. people with time) to make existing
content up to date.

Regards,

JPS.

Łukasz Nowak a écrit :
> Hello,
>
> There is a note on ERP5 Wiki[1]:
>
>   
>> There is also some general and introductory material on
>> community-maintained ERP5 Handbook. The Handbook is a separate
>> structure for now and contains many inadequacies thus should not be
>> trusted, but is going to be merged with this wiki once it is reviewed
>> and all errors fixed.
>>     
>
> I feel quite responsible for setting up and trying to improve and
> maintain ERP5 Handbook. Concurrently I try to improve ERP5 Wiki as much
> as possible.
>
> I think, that coexistence of ERP5 Handbook and ERP5 Wiki might be
> discussed here on mailing list.
>
> Those are my thoughts (ERP5 Wiki - 'wiki', ERP5 Handbook - 'HB'):
>  * wiki is focused in providing technical, detailed, "ascetic"
> information, focused on ERP5 community members who have some experience
>  * HB is focused on providing complete set of rough, introductory,
> tutorial-like documentation for ERP5's primers
>
> I've created note for authors what shall be put in HB and what on
> wiki[2] but I think it would be great if alliance to work on those
> documents might be set up to minimize repetition and give place to
> contribute for both kind of people - technicians, which are great in
> providing clear and concrete information (but, which is
> understandable for primers) and "story-tellers" which will provide more
> words about important topics, even in expense of "inadequacies".
>
> What do you think? Please let there be a storm. Brainstorm.
>
> Regards,
> Luke
>
> PS. About inadequacies - please feel free to correct them in HB.
>
> [1]http://www.erp5.org/Documentation
> [2]http://en.wikibooks.org/wiki/ERP5_Handbook/Meta#What_to_put_in_handbook_and_what_on_wiki
>   


-- 
Jean-Paul Smets-Solanes, Nexedi CEO - Tel. +33(0)6 62 05 76 14
ERP5 Enterprise: Free / Open Source ERP for Critical Applications
http://www.erp5.com
ERP5 Express: Hosted Open Source ERP for small companies
http://www.myerp5.com
Nexedi: Consulting and Development of Free / Open Source Software 
http://www.nexedi.com