[Erp5-dev] Experimental repository documentation structure

[Łukasz Nowak]

Hello,

On 2008-03-20, 23:04:27
Jean-Paul Smets <jp at nexedi.com> wrote:

> Hi,
> 
> I think it is a good idea for those who contributed to experimental
> that they provide a bit of documentation about experimental ie.
>     - explain the purpose of experimental (please let me write a
> guideline for this part, what you call HowToUseExperimentalForge)
>     - provide documentation for experimental stuff.
> 
> This structure (based on your suggestion):
>        - HowToUseExperimental (main page containing a list of
> HowToUseExperimentalXXX)
>        - HowToUseExperimentalCore
>        - HowToUseExperimentalXXXX
> is OK in my opinion
> 
> Each HowToUseExperimentalXXX should contain a link to the SVN
> repository.

So I'll prepare it.

I think about to merge http://www.erp5.org/ExperimentalRepository into
http://www.erp5.org/HowToUseExperimental , with redirect
ExperimentalRepository -> HowToUseExperimental . Is it ok?

> About the content of experimental, it contains good things which will
> be integrated to the core some day. It also contains some ad hoc
> solutions which solve real problems in certain case but cause more
> trouble in other cases. So, it is a good idea to warn users that they
> should not rely on experimental and that using experimental could
> well lead to data corruption (although it is not intended to).

It would be great if such disclaimer would be available as moin macro
and include it on *every* experimental related page. What do you think?

Regards,
Luke

-- 
Łukasz Nowak R&D Ventis http://www.ventis.com.pl/
tel: +48 32 768 16 85 fax: +48 32 392 10 61
``Use the Source, Luke...'' I am only craftsman.