On Sat, Sep 26, 2009 at 00:51, Slava Pestov <[email protected]> wrote: > On Fri, Sep 25, 2009 at 3:49 PM, Alex A. Naanou <[email protected]> wrote: >> 1) there appears to be a total lack of general documentation on most topics. > > What do you define as general documentation? Most of the language and > library is documented. You can browse documentation in the Factor UI > or at http://docs.factorcode.org. > >> 4) finding relevant and "clean" examples in the library code proved >> non trivial, especially for an outsider. > > http://concatenative.org/wiki/view/Factor/Examples
the docs are quite good if you know what you are doing and where to look for it, but when you are browsing around trying to figure out how the comething works and how to use it, there is very little read... for instance: let's take the objects, you have a general object definition in the root section of the lang-doc, and subsections describing concepts, but it is not clear which concept is which or does what... this particular case can be solved with a more detailed explanation of each subsection in the root doc. I'd also add something like "object lifespan" to describe how an object is created, how it relates to classes, general manipulations one can perform with it and how/when it is destroyed... ...and, the current doc describes cloning in the Equality section which is quite illogical, in my noob view at least :) you have a good tutorial, but it ends where it ends... P.S. I know it's just a hot-key away, but for everyone who's running the listener for the first time and does not know the hot-keys yet adding a "help" or "docs" button would help a great deal ;) > > Slava > > ------------------------------------------------------------------------------ > Come build with us! The BlackBerry® Developer Conference in SF, CA > is the only developer event you need to attend this year. Jumpstart your > developing skills, take BlackBerry mobile applications to market and stay > ahead of the curve. Join us from November 9-12, 2009. Register now! > http://p.sf.net/sfu/devconf > _______________________________________________ > Factor-talk mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/factor-talk > -- Alex. ------------------------------------------------------------------------------ Come build with us! The BlackBerry® Developer Conference in SF, CA is the only developer event you need to attend this year. Jumpstart your developing skills, take BlackBerry mobile applications to market and stay ahead of the curve. Join us from November 9-12, 2009. Register now! http://p.sf.net/sfu/devconf _______________________________________________ Factor-talk mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/factor-talk
