[Laszlo-dev] Which documentation should be used for OL 4.0.18?

[Raju Bitter]

Thanks for you response. I thought that the line had been taken out  
for 4.0.x at some point, but it seems that's not the case. The reason  
I'm asking is that I'm on a project where the customer uses the doc  
pages, and they asked me if they should use 3.4. I just wasn't sure  
what might be missing, but we'll just use 4.0.18 docs then. Thanks!

On Sep 21, 2009, at 6:33 PM, Lou Iorio wrote:

> The reason the warning was there was that the 4.x doc was missing  
> stuff
> that was in the 3.4 doc. Some things just got lost in the transition  
> from HTML
> to XML. (I'm guessing; that was before my time.) For example, entire  
> "See
> Also" sections (lists of links to related docs) were omitted entirely.
>
> Can't you use the 4.0.18 doc? That would seem to be the safest  
> thing. If not,
> I agree with Tucker.
>
> On Mon, Sep 21, 2009 at 11:50 AM, P T Withington <ptw at pobox.com>  
> wrote:
> Well that warning will never go away in the 4.0 line, as that line  
> is no longer actively developed.
>
> The major API changes came with 4.2 (which we all know in hindsight  
> should have been 5.0).
>
> But, unless you are doing something pretty obscure, you should be  
> able to use either doc set. Our goal is to try to maintain  
> compatibility.
>
>
> On Sep 21, 2009, at 11:05, Raju Bitter <rajubitter at me.com> wrote:
>
> Good question. I still see the warning for the reference guide for  
> OL 4.0.18: Documentation in progress: please use the 3.4 Reference  
> Manual
>
> It was initally added here: http://jira.openlaszlo.org/jira/browse/LPP-4539 
>  , for OL 4.0.6
>
> John's comment:  "The OpenLaszlo 4.x Reference Manual is alpha  
> quality. The information on this page is believed to be correct, but  
> some information may be missing. We recommend using the OpenLaszlo  
> 3.4 Reference Manual, since the APIs are essential identical between  
> OL 3.4 and OL 4.x. The OpenLaszlo 4.0.5 Developer's Guide should be  
> used in preference to the OL 3.4 Developer's Guide, however."
> http://jira.openlaszlo.org/jira/browse/LPP-5436 And updated for 4.0.10
>
> Didn't find anything else in JIRA on it.
>
> On Sep 21, 2009, at 4:44 PM, P T Withington wrote:
>
> Are there not docs for 4.0?  IIRC the main reason the 4.0 docs  
> referred you to the 3.4 docs was because the new doc tools didn't  
> make pretty enough documentation.  Not because the documentation was  
> wrong.  But, maybe I mis-remember.
>
> On 2009-09-21, at 10:28, Raju Bitter wrote:
>
> Which is the best documentation available for OL 4.0.18? Should we  
> use 3.4, or rather the OL 4.1 docs?
>
> Thanks,
> Raju
>
>
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20090921/f24eda22/attachment.html