Quick intermediate manual

134 views
Skip to first unread message

Luis Gonzalez

unread,
May 12, 2017, 6:51:38 AM5/12/17
to TiddlyWikiDev
Is my intention to write a quick intermediate manual of Tiddlywiki. In its first stage it will be written in Spanish but as soon as we can we will translate it ito English.

I am gathering material to include. Any help is welcome.

Manual.pdf
elements.png

TiddlyTweeter

unread,
May 12, 2017, 10:35:41 AM5/12/17
to TiddlyWikiDev
That looks brilliant!

I can read Spanish (but don't ask me to write it, please :-). What you already written is great!

What I like about it is how it uses, very well, VISUAL CHARTS to depict fundamental things.

IMO that is exactly right for TiddlyWiki which is simultaneously dynamic in many directions. Simple procedural explanation does not really capture what it can do in the way those diagrams can.

I have two comments on what might be interesting for you ...

1 - Explanation that its possible in ONE Tiddler in TW to combine macro code, HTML markup and WikiText. That is very unusual. So unusual it took me months to realise that. Odd as it may sound most documentation elides this simple point.

2 - Central to TW are LISTS & FILTERS. Understanding these two aspects of TW I think gives a fundamental foundation in what it can do. Tobias Beer's work on this is superb because he helps you get an overview. For example: http://tobibeer.github.io/tw/filters/#Filter%20Examples. Even so its still too linear IMO to fully put it in context. I'm interested to see how you might present that.

Very best wishes & thankyou!
Josiah

Mat

unread,
May 13, 2017, 4:13:55 PM5/13/17
to TiddlyWikiDev
Nice.

Who's the target audience?

Would it be a bad idea to make it as a TW instead of a document?

<:-)

Luis Gonzalez

unread,
May 24, 2017, 6:44:06 AM5/24/17
to tiddly...@googlegroups.com
I think there is a high learning curve of the internals of TW.
I want to improve this learning curve with visual helps to increase the number of people who write good advanced code / tiddlers / plugins / widgets / macros.

Is imperative to have visual helps as conceptmaps or mindmaps and not only wiki notes.
And there is many many people who still works with pdf manuals.
I don't mind to put all this notes inside a wiki. I'm still looking for the best way to make good documentation available to people and the format that this information will have.


So the purpose: increase the number of good applications made with TW, and the audience: all people who want to work with and like TW not only as a note taking method, but as a full application.


I am upgrading the manual.
In italics I want to include a exercise of writing, for exaple, a GTD wiki, but this part is still in development because I don't know many things about the internals of TW.

Anybody who whant to help me, please send me documentation notes of all holes that the manual has.

Thanks  to all !!!!
Manual.pdf
Reply all
Reply to author
Forward
0 new messages