Colm wrote: > For TiddlySpace Osmosoft have been assembling documentation in > a number of spaces, collected in the umbrella @docs space: > > http://docs.tiddlyspace.com > > Much of this documentation also applies to TiddlyWiki, as well as > TiddlySpace. It's not as open as TiddlyWiki.org in that only a few > people are currently able to directly edit the tiddlers.
Hi Colm, I saw this space, BUT the big problem is: What is applicable to tiddlywiki , and what is applicable to tiddlyspace/web? It is sometimes hard to figure, especially for a novice. Tiddlywiki.org is easy enough about tiddlywiki, so I know it applies. When I look through tiddlyspace I usually get something like: "just include this space". For me that implies I have to try to import the tiddlers of this space in a tiddlywiki to see if it works. And often it does not, which is to be expected. Paul wrote: > Another issue is that we've had difficulty separating "developer" > documentation from "end user" documentation. My personal view is > that the distinction of roles isn't always useful, but I realise > others > think it's essential. > > My own personal prejudice is that reference documentation about > code maintained separately from code is always out of date, so > I'd push for authors of plugins to document in the plugin tiddler, or > in an associated "info" tiddler, and maybe we could look again at > generating docs from the core code, though that's something of > a hardy perennial. > For me the distinction between end user and developer is very fluent. I consider myself an end user, but I have no problem reading the plugin code or using a little js. I think just mixing all documentation and tagging it with levels like: easy - requires js knowledge - requires html coding etc. would be fine. Vlak -- You received this message because you are subscribed to the Google Groups "TiddlyWiki" 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/tiddlywiki?hl=en.
