Eric, Thank you for making your response "entirely too long": it is entirely, and extremely good and useful.
On Jun 12, 1:52 am, Eric Shulman <[email protected]> wrote: > While jQuery is very good for manipulating *DOM elements* (rendered > page content), it really doesn't have any bearing on the TW internal > store "object", which is where the actual *data* for all tiddler is > kept during the session. Yes: so that is why it is important to understand the core structures. > Learning the TW core object model can be somewhat confusing, primarily > due to lack of comprehensive (or even adequate) documentation (except > for reading the code itself, which is sparsely commented). Documentation is always a pain, because once one is fluent in the "language" --tw or javascript-- the code seems self-documenting and comments feel redundant. And so they are for the fluent programmer. But open-source software has to be well-commented, because it requires many hands to keep it going and training for new volunteers. That is why I think Knuth's idea of literate programming will eventually make its way into the programming world. It seems odd in some ways that tw is poorly documented, only because in tw there is a such blurring of code and data. There should be some kind of automatic documentation process, à la java. Your insideTW is certainly a big step in the right direction. Another of a long list of crucial contributions that the tw community owes you. > > Here's some starting clues: > > There are THREE different ways that tiddlers are represented in TW: As usual, such a clear presentation of the core. (You are living proof of what Knuth understood: good programmers are good writers and clear thinkers. It is the clear expression that is the real focus of large programming projects, even more so than the clever solutions to local problems.) > anyway..... this message is entirely too long.... :-) > Thank you for this excellent tiddly lesson! A collections of such messages (for tiddly.org?) would serve as the perfect on-ramp for potential tiddly troupes :). Best, Bill -- You received this message because you are subscribed to the Google Groups "TiddlyWikiDev" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/tiddlywikidev?hl=en.
