Hi Jeremy keeping the main docs on tiddlywiki.com is great.
I was also concerned with the documentation for and surrounding tiddlywiki. Vlak On Nov 29, 1:41 pm, Jeremy Ruston <[email protected]> wrote: > My goal is to get authoritative reference documentation built into > tiddlywiki.com, so that all the key information is easy to pick up and > take with you when working offline. > > The plan is to feed it from the reference information that we're > assembling over on tiddlyspace. > > When the documentation on tiddlyspace is mature and useful enough, I'd > be hoping to switch tiddlywiki.org over to it. (We do have to make > some improvements before that's possible, like better interactions > with Googlebot). > > Cheers > > Jeremy > > > > > 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 > > athttp://groups.google.com/group/tiddlywiki?hl=en. > > -- > Jeremy Ruston > mailto:[email protected]://www.tiddlywiki.com -- 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.
