Yes, the tab would be immediately doable (as displayed here, by Tobias apropos another discussion). But I think that most of these things (and what I'm about to show below) we already have almost all the pieces for. But then, I'm no programmer ;-)
What, as you put it,
"sort of help" is IMO not really an issue - I mean, you can ask
that same question about the help we are currently providing. The answer
is probably; the best kind of help we've managed to scrape together for
the moment. Anything is better than nothing.
Anyway, over night the ol' brain decided to bring forth yet a
touch; to use the sidebar Help tab itself as the area for this help
presentation! Here are some furtherifications:
--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
For more options, visit https://groups.google.com/d/optout.
I do wonder whether these blow-by-blow instructions are appropriate in empty.html. The alternative would be to have a "getting started" edition (perhaps the same as the "introduction" edition) that is specially geared to taking the user step-by-step through the installation and saving process. Once the user has achieved that tutorial then maybe they'd be best served with an empty.html that was relatively brief, mostly being links to material elsewhere.
I admire your ability to turn around mockups, they work really well and communicate very clearly.
I've actually also thought about having a "help" mode, I think it could work well, but obviously not something I want to do during the moratorium.
I'm keen to get some reworking of GettingStarted for 5.1.6 (which is now a few days overdue) so I've incorporated some of your ideas in an update here:I'd appreciate comments and suggestions.
The approach to giving different instructions for different browsers is clumsy. On tiddlywiki.com/index.html we use the browser-sniff plugin that lets us conditionally show material based on the current browser. To use that in GettingStarted we'd need to move that plugin into the core.
I do wonder whether these blow-by-blow instructions are appropriate in empty.html. The alternative would be to have a "getting started" edition (perhaps the same as the "introduction" edition) that is specially geared to taking the user step-by-step through the installation and saving process. Once the user has achieved that tutorial then maybe they'd be best served with an empty.html that was relatively brief, mostly being links to material elsewhere.
I haven't embedded the video because there are some privacy issues - as things stand, Google/YouTube would get pinged each time empty.html was opened (including when opened locally from a file: URI). We need a new video macro that displays a local static thumbnail until it is clicked.
prof. Kimmel? prof Kimmel?!? hmm. prof Kimmel. I like it.
--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
For more options, visit https://groups.google.com/d/optout.
I've simplified empty.html's GettingStarted to remove the tabs. I think, at least for the moment, that we should keep it simple, and link to help material elsewhere.
simplified
I think it's important to remember who are target audience is with the Empty file's GettingStarted tiddler. The audience for this tiddler is the new or inexperienced user. The experienced user doesn't need it and probably replaces it without even reading it.
With that in mind, I have a few critiques and suggestions for the GettingStarted tiddler.
1. All reference to the Control Panel has been removed. By comparison, the GettingStarted tiddler for the classic version contained essentially nothing but references to what are now control panel functions. For those who have forgotten, the GettingStarted tiddler for the classic version contained just five lines which were:
To get started with this blank TiddlyWiki, you'll need to modify the following tiddlers:You'll also need to enter your username for signing your edits:
- SiteTitle & SiteSubtitle: The title and subtitle of the site, as shown above (after saving, they will also appear in the browser title bar)
- MainMenu: The menu (usually on the left)
- DefaultTiddlers: Contains the names of the tiddlers that you want to appear when the TiddlyWiki is opened
It might be worth considering whether our new users would be better off if the GettingStarted tiddler contained something like that.
2. Step number three, "Click the red in the sidebar on the right " is unnecessary and confusing. The New User is going to be working with the Empty.html as downloaded. That file is preconfigured to Autosave whenever the user clicks on the tick mark button that accepts the changes to the tiddler. The only time the New User will need to hit the button described in step 3 is when they make a change to control panel settings. This statement should be included in the GettingStarted after the statements that reference the Control Panel.
By my reckoning, no one who can figure out how to change the Autosave setting qualifies as a brand new user.
3. For the New User, the most important aspect of the Getting Started process and the first thing I would mention is how to make sure you can actually save the tiddlers you create. There aren't many things as frustrating as spending time working on something only to have it vanish into the ether. Accordingly, I would have the first thing they see be something about checking the setup.
4. Do we expect there to be any members of the target audience using TiddlyDesktop? My guess is no. And the line basically says that if you are using TiddlyDesktop, you don't have to worry about what this tiddler says. I would delete it unless the goal is to promote TiddlyDesktop.
5. I would include the lines about the TiddlyFox addin including the links here rather than forcing the New User to go back to the main site to read it.
And while I'm making suggestions, I wouldn't force the new user to leave the tiddler to go get information about installing addins so they can make TiddlyWiki work. If you don't want to include all that and the plugin in the basic empty set, you can always have the user tell the program what browser they are using and have the program load the appropriate file with an html iframe statement. It might be something like <iframe width="100%" height="650" style="border:none;" src="http://tiddlywiki.com/firefoxstart.html" scrolling="yes"></iframe>.
--
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tiddlywiki+...@googlegroups.com.
To post to this group, send email to tiddl...@googlegroups.com.
Visit this group at http://groups.google.com/group/tiddlywiki.
For more options, visit https://groups.google.com/d/optout.
I'm keen to get 5.1.6 out soon, so all this help is much appreciated,
How did you find those missing tiddlers under the missing tab?In the Emptly.HTML there are no missing tiddlers but 'TiddlyWiki' is linked too and does not exist.
I agree that having missing tiddlers should be minimized / eliminated.Can we help with that Jeremy? If so how?
And I think that TiddlyWiki should be defined in an empty TiddlyWiki
As I have said before I like the biggest name I can get and I know I am in the minority, this would be my choice for naming structure TiddlyWiki-5-1-6-empty.html.
And I think that TiddlyWiki should be defined in an empty TiddlyWiki+1
IMO, missing tiddlers simply looks like it's some error which is confusing.
One half measure idea would be a some text in faint gray in each missing tiddler informing that [there is no content in this tiddler]. (Not quite true if it's not a tiddler to begin with.)
Another route might be to de-linkify them with "~"
I was trying to start a new TW with all the Missing files and I was going to start making them.