TiddlyWiki / TiddlyWiki5

A self-contained JavaScript wiki for the browser, Node.js, AWS Lambda etc.
https://tiddlywiki.com/
Other
7.99k stars 1.18k forks source link

[tw.com] The tiddler Concepts should include brief summary for each concept #1717

Open twMat opened 9 years ago

twMat commented 9 years ago

The tiddler titled Concepts would be more informative if each item included a very brief summary, such as a transclusion of its first paragraph, like this:

skarmklipp4

Jermolene commented 9 years ago

Hi @twMat

Two things: perhaps it would be better to present the concepts in order of increasing complexity, rather than alphabetically. Start with the basics, go on to the more complex. I'm not sure that those summaries need to be within the corresponding "concept" tiddlers in the first instance; why not just write them in this tiddler and then we can look at whether it makes sense to refactor them.

twMat commented 9 years ago

Two things: perhaps it would be better to present the concepts in order of increasing complexity, rather than alphabetically. Start with the basics, go on to the more complex.

Well, I believe that the more educational tw.com is, the more user value and the better for the spreading of TW. So I like the idea. But do you have a clear sense of what you mean with "in order of increasing complexity"? In drafting on my informal Good-to-Start-With List I realized there are a few dimensions such as level of TW-experience, level of coding experience, how fundamental a concept is, how frequent it is, etc. I.e. even from an educational view, there is more than one order.

I'm not sure that those summaries need to be within the corresponding "concept" tiddlers in the first instance; why not just write them in this tiddler and then we can look at whether it makes sense to refactor them.

The example to transclude their respective first paragraphs was merely for convenience as these paragraphs are more or less already summaries.

Jermolene commented 9 years ago

Hi @twMat I do believe that there is a logical ordering with which the TiddlyWiki-specific concepts can be introduced, starting with the idea of a tiddler, moving through fields, wikitext, etc. such that each concept only references concepts that have already been introduced.

danielo515 commented 9 years ago

I think what Jeremy means is to introduce before the most basic and independent independent concepts before those concepts that depends on the comprehension of those already explained.

twMat commented 9 years ago

I think what Jeremy means is to introduce before the most basic and independent independent concepts before those concepts that depends on the comprehension of those already explained

Yes, makes sense and it's a good strategy.

Jermolene commented 9 years ago

I meant to add that the "Introduction" edition was an unfinished attempt to weave TW's fundamental concepts into a sequence:

http://tiddlywiki.com/editions/introduction