[Erp5-dev] Experimental repository documentation structure
Łukasz Nowak
lukasz.nowak at ventis.com.pl
Fri Mar 21 13:32:45 CET 2008
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.
More information about the Erp5-dev
mailing list