[Laszlo-dev] doc for incubator items?

[Lou Iorio]

The index.html page in the incubator directory says this:

The Incubator directory contains components and other code that have  
been contributed to the OpenLaszlo project, but have not yet been  
fully integrated into the product. It is intended as an easy way to  
contribute code that doesn't have the level of documentation,  
testing, or API review that is required in other directories, or that  
is simply contributed too late in the release cycle to place elsewhere.

Is it our intention to move some of this into the product proper at  
some point?

Until then, I don't think it should go into the documentation,  
especially since
it has not been properly tested. If we documented it, wouldn't we be  
obliged
to support it?

At this point incubator is not even mentioned in the dguide (not that  
that's
necessarily a good thing).

Lou

On Feb 21, 2008, at 8:49 AM, Donald Anderson wrote:

> I (privately) modified the generation of the navbar menus to show
> anything that looks like a tag for all the  docs/reference/*.html  
> files.
> As a side effect, I'm picking up stuff in the incubator, much of which
> does not have much documentation.  Should I leave incubator out?
>
> It might be nice someday to include it and have the menu item say:
>    colorpicker (incubator)
> and have a banner across the shown page to indicate it's in the  
> incubator.
> But I can leave that for another time if we leave incubator out of the
> documentation.  There's so much more to do.
>
> - Don
>
> --
>
> Don Anderson
> Java/C/C++, Berkeley DB, systems consultant
>
> voice: 617-547-7881
> email: dda at ddanderson.com
> www: http://www.ddanderson.com
>
>
>
>