* Alessandro Manotti <[EMAIL PROTECTED]> [060503 09:35]: > > Yes, Rebol syntax may become ugly . > I solved the problem (I think...) by commenting the lines, and writing > "What I am doing in the next block of code". The block must be short. Right on!
I write my best code when I do the following. First comment Then code tj > e.g.: > > ; main block: what's its job? > > ; subblock 1:what's its job? > ; subblock2: what's its job? > > ....... > > (see my JellAp application: I think it is quite self-explanatory... I > think and I hope!!!). > > http://ale870.pbwiki.com (Jell Project -> JellAP). > > > --Alessandro > > > > > On 5/3/06, Tim Johnson <[EMAIL PROTECTED]> wrote: > > > > * Alessandro Manotti <[EMAIL PROTECTED]> [060503 05:06]: > > > > > > I think direct help supplied by rebol (from console use ?) is the first= > ste=3D > > > p. > > > Then I hope developers of the dialects need to create the right > > > documentation, as per any programming language! > > > > I use a dialect called 'ml developed by Andrew Martin. It renders > > html/xml content. Runs rings around Python HtmlGen. > > > > I'm rewriting my own sql dialect, which runs "on top off" > > mysql-protocol. It will make composing sql querys much easier. > > > > I'm a "part-timer", i.e., I write about equally in python and > > rebol plus javascript and some lisp. The glory of rebol is that > > you can (like lisp) actually process symbols (words) - and that is what > > enables DSL (domain-specific-language) approaches. > > > > The disadvantage of rebol is this: > > > > Code can very quickly become unreadable. Documentation is really > > helpful for me to learn how the real rebol gurus do things. Whereas > > python lends itself by it's own syntactical rules to extreme > > readability rebol's 'freedom' can quickly lead to obfuscation. > > > > I'm emberassed to say, that although I've never written a single line > > of perl code, I can very often better understand what my partner's > > perl code is doing than some *very high-level* rebol code. > > > > In my opinion, as the complexity of the resource (DSL, protocol, > > function etc) grows, so should the documentation grow. > > > > Here's a link to a python module that I've written. When you point > > directly to it, it renders its own documentation. > > > > http://www.wabo.biz/cgi-bin/py/fdb.py > > > > Python makes it easy to create modules this way, and it can be done in > > rebol too. > > > > MTCW > > tim > > > > -- > > Tim Johnson <[EMAIL PROTECTED]> > > http://www.alaska-internet-solutions.com > > -- > > To unsubscribe from the list, just send an email to > > lists at rebol.com with unsubscribe as the subject. > > > > > -- > To unsubscribe from the list, just send an email to > lists at rebol.com with unsubscribe as the subject. -- Tim Johnson <[EMAIL PROTECTED]> http://www.alaska-internet-solutions.com -- To unsubscribe from the list, just send an email to lists at rebol.com with unsubscribe as the subject.
