Scripting a tour through a map

The one thing that led me to try out Tinderbox was that it is said to so very flexible that can do so many different things for different people. So I intend to see how far I can take the idea of explaining Tinderbox inside Tinderbox. I know there are probably limitations I am not aware of today, but I’m quite confident working in in complex spaces, and in environments with a lot of uncertainty.

Your experience and feedback is very welcome. I learn a lot from it, even though I might not always do what you suggested.

And you are correct, I do misunderstand a lot. I know I make a lot of mistakes. That’s why I’m putting my tutorial out to get feedback early. When I learn something, I simply update the tutorial.

That being said, the tutorial does not need to be perfect to be of value, as long as it’s helpful for some people — and initial feedback would indicate that might be the case — that’s something.

Tight feedback loop with users appear to work pretty well for me and for the organizations I am coaching.

When things I say come across as judgmental, I am sorry for that. I will try to consider if there is a better way of expressing what I think. I am German, and I have heard people say I do get to the point fast without pleasantries, so there might limitations how far I will be able to overcome my character and cultural heritage.

So whenever you can point me to a specific judgement you find factually inaccurate, or provide a more elegant description of something I wrote, I’ll be happy to consider it.

1 Like

I find myself wondering if it might be beneficial to look at how various people use Tinderbox in order to get a sense of what is possible, and indeed how different the app can be when the user’s requirements are different. If I’m not mistaken the home page of the app website has some examples of different use cases. And there are many discussions in the forum. I’ve been involved in a few myself, which I have found very helpful. I started this one, which went a lot further than I was expecting when I began it:
http://forum.eastgate.com/t/user-attributes-or-tags/1069?u=martinboycott-brown
I remember James Fallows commenting that for him the app was more about associations than hierarchies, and that has stayed with me ever since. Perhaps one of the most useful insights I’ve had into using the app. And what follows from that is that various ways of displaying those associations are very useful.

Sounds reasonable.

That also sounds reasonable.

It also sounds like overkill for what I was trying to do. I was just looking for a way to access some properties of the window, mainly path, coordinates, and zoom factor, to see if I could use that to make the first part of the tutorial foolproof, until the user has learned enough about navigating a Tinderbox document. But maybe it’s really already good enough, and all that is not necessary.

It’s not my intention to create a huge map, currently I have individual lessons inside containers, and I think that works quite well.

For now, my idea is limit the tutorial to one tab, I believe there should be one obvious way to start to keep it simple for new users… I intend to teach the user how to open more tabs for exploring other views, so that they can keep open the tutorial as a map in one tab, and then look at e.g. the outline view inside a container that has data that makes sense in an outline.

Yes, that is obvious.

I really like the challenge of using Tinderbox to teach Tinderbox. And what I learn is very helpful for using Tinderbox to make sense of my actual field of study.

Yes, I have read those already, and also linked up inside my tutorial because that is a relevant resource for a new user.

Thanks, that thread looks interesting, I will read that more thoroughly when I find some time.

The idea of associations over hierarchies resonates strongly with me. Hierarchies are a dominant and normative ideology: We are trained to see hierarchies everywhere, even though they are quite rare in the real world. Letting go of that leads to surprising insights.

And the tutorial succeeds in doing that in a way that a more passive presentation might not. In the first couple of versions, using the map rather than text links is valuable; by moving through the tutorial, the user has to navigate a map - not a typical thing to do, and your text guides both that navigation and learning. Your use of Next as link names, along with your placement of note spaces on the map, seems to be plenty to guide navigation - as well as being examples of good practices for novices to be aware of.

Is it foolproof? Probably not, but there are ways to recover from getting lost. Centering the learner’s attention can be done by pointing to elements with text (over to the left, at the top). Might be possible to bold or color a text element to focus on. You use color to give the learner focus on specific notes: that could be done with text elements.

As you move into tutorial sections about text links, then moving to using text links to navigate instead of the map might be the thing to do.

Ditto when you introduce hierarchies of containers: Introducing navigating by outline view seems appropriate at that point. Doing so makes your point that “Hierarchies are a dominant and normative ideology: We are trained to see hierarchies everywhere”. By starting with map view, which lets the learner get comfortable with the map, containers, and navigating using a map, and bringing hierarchies later, you set things up for that larger idea of association. You’ll be hard pressed to do that in a Prezi.

You make a convincing argument that it works well enough. They means I can focus my time on creating more content, rather than on finding better ways of navigation.

These are very helpful suggestions, I will think about how to implement them.

I think that is the way forward, especially so for exploring other views that the map view. Once the user knows how to use ⌘’ repeatedly to backtrack to previously visited notes, they can always come back to the last tutorial note they visited.

One thing I have yet to find out is what is the set of basic skills I need to cover in a guided tour of mini-tutorials, so that on top of that I can create other tutorials the user can tackle in any ordert they chose. Navigating Text Links is definitely part of that set.

I am currently working on a tutorial for the Hyperbolic View, where at then end of the tutorial I let the user explore my (still unfinished) map of Tinderbox concepts that is also part of the document, so the user can see how different that map looks in this view.

To build on what you’re saying, it’s probably a good idea to have the user revisit the same map in the Outline View, to appreciate the difference that makes.

Thanks for your insights, I now see some things much more clearly.

Dear Lizard-of-Oz.
Thanks a lot for your TinderBox tutrial.

This may be a silly question, but when I open with TinderBox 8.6.2 , tutorial map view window become Black.
I can not read it absolutely, non of the tutorial messages under right-hand side"map view".
Using TinderBox 8.5.1, strangely enough, I can get revert to type where evry indicative informations without difficulty.
I would like to know and to take advantage of your expertise,
why I have such a difference between TinderBox 8.6.2 and 8.5.1?
My circumstance : OSX10.12.6 (Sierra) with Mac mini 2012.

thx and regards, WAKAMATSU kunimitsu

There are lots of tutorial files, and you don’t give a filename, but my guess is the issue here is files crossing light/dark OS mode. I realise you are using macOS 10.12.6 but the issue is not just the OS but the effect on the file.

Open the tutorial, then Document Settings (Cmd+8), Colors tab and select ‘Tinderbox 7’ and apply. I hope that will fix the issue (if it does, the ‘fix’ should work for other files).

Did that help?

Dear mwra,
Thank you for your help.
I get it. Curious to say, I need not to change Colors from Document Settings.
I do not know why and where comes this modifier?
Anyway, TNKU.
thx and regards, WAKAMATSU Kunimitsu
P.S
Tutorial file comes from here.
Scripting a tour through a map - Tinderbox Tasks - Tinderbox Forum

Your link is to a Prezzi [sic] file not a Tinderbox file. This might be the problem.

I’m sorry, I am not sure I understand. I don’t mean to sound rude - I am aware working in my first language :slight_smile:. So, do please ask if you still need help to open the tutorial file.

Dear mwra,
I have a same trouble using your starter file for TinderBox v.8.5.0.
[Starter file updated for v8.5.0]
Right-hand side"map view" completely turned black.
I can not change even follow your advices, to open your starter tutorial file , then Document Settings (Cmd+8), Colors tab and select ‘Tinderbox 7’ and apply.
Still black colour ! with TinderBox 8.6.5 under Sierra OSX 10.12.6.
thx and regards, WAKAMATSU kunimitsu

I got this former tutrial from
Scripting a tour through a map.
by Lizard-of-Oz.

I’m very confused:

The view pane (what were ‘major views’ in v5) is always the left pane of the Document Window.

The latest version is v8.6.2!

Could you upload a copy of the problem file to the forum? (it allows TBX file uploads)

Dear mwra,

Sorry my type missing. TinderBox 8.6.2 is correct.
I will send your tax file.
starter8-5.tbx (274.4 KB)
thx and regards, WAKAMATSU kunimitsu

Dear mwra,
I need to correct an entry such as from your tax file to your Starter 8-5 tbx. file.
I wrote the wrong naming.
thx and regards, WAKAMATSU kunimitsu

I don’t have v8.5.x installed, only v8.6.2. In that app, the TBX file works correctly. In case it helps, I have taken the file you have uploaded and, on my Mac, re-applied the ‘Tinderbox 7’ colour scheme.

† I am using the current, patched, macOS 10.14.6.

Here is the file: starter8-5.tbx (279.6 KB)

If you still have a problem, I suggest contacting support (info@eastgate.com) as something else may be corrupted.

I’ve checked the original file you downloaded ()and it does not show the problem you describe so this suggests the problem is caused by changes you have made since downloading it.

Dear mwra,

Fall into place.
Thanks a lot.
thx and regards, WAKAMATSU kunimitsu

1 Like

Happy to help! Thank you :grinning: