Sample projects as templates for learning Tinderbox

I’m still trying to figure out a better way for me to get familiar with using Tinderbox with a moderate degree of fluency.

It’s pretty obvious that having a project to work on with it would be the best way to do this.

So far, the projects that I’ve come up with that I care about fall into two categories:

  1. The project is simple enough that Tinderbox doesn’t offer anything significant over other tools.
  2. What I want to do with the project is much more complicated, but getting through the complexity gets in the way of progress on the project.

Would anyone like to describe a project you have that’s somewhere in the middle of those? If we have a collection of such things, it might be possible for newer users to pattern-match against them to get a quicker start.

Thanks!

P.S. An alternative strategy is to try with a simple project to practice the basics. I get that. I haven’t had one recently that could absorb the overhead time for learning Tinderbox; the main thing is that the important projects I have are complicated, and in category #2.

What general sort of task do you do? It might help if suggestions made have some similarity to what you’re trying to do.

Thanks, Mark.

For me: generically, research and writing projects, often with a historical component (which makes timelines interesting). The other big one is organizing my computer security class, which is the one where I have gotten bogged down in trying to do some things that are more complex, and then the class actually has to happen.

Part of my thinking was that example projects might help others new to Tinderbox, with a wider variety of projects, but maybe I’m off-base on that.

If the case is “I really want to learn how to use Tinderbox” but “I’ve been thinking about this for a while, but I cannot come up with a good trial case”, then maybe “I’ll put this aside for now and come back to Tinderbox when a good idea arises”, or maybe “nah, not for me”?

Thanks. I think a challenge here, reflecting on my own research, is that it is rarely the same twice. I’ve come, mainly through long use, to understand the ‘toolbox’ aspect of Tinderbox. IOW, it can do what I want, perhaps not exactly in the way I first imagined, but I have to figure out the subset/order of tools to use. As most software offer a reward for correct input/process, we are unwittingly trained to expect a different approach: IOW what it the right button to push, right way to feed the process.

Also, when it comes to text, we are generally over-trained to the paper model (mainly via word processors): start at the top left corner and write a single long narrative. Some apps like Scrivener deliberately subvert that with its outline. Tinderbox takes things further. If we embrace the notion of many small pieces, Tinderbox shines. Reflecting, many threads about previewing, composite note preview, etc., show how deeply ingrained as the ‘norm’ and we push back against any different approach. I’ve pushed through that—I know as being asked/forced to use a word Processor (Word, Google Docs, etc.) leaves me unhappy if the work is anything but short/trivial. I prefer the hypertextual approach: write what I need in modular form, link/arrange as necessary, oultput/render as needed for the task at hand.

The toolbox approach dovetails with understanding of the tools and there I sense you have a head start as your experience of programming (or programmable text editors) means much of the action code operators should not seem too alien.

So perhaps the missing part is some tutorials that open up the interplay between task, tools selection and ‘process’ definition. It definitely helps to read up on what the view/text panes offer before planning what we want to see. Again, questions here often arise because people are working to imagined view/render rather than one the Tinderbox toolbox actually offers. Embracing the latter pays dividends. The genesis of many of the aTbref articles has me been figuring out the reality of the description of a feature in terms of how it works/is user-configured.

Another aspect overlooked, for research/writing is the body text vs metadata (attribute value) balance. If coming from a long-form text perspective, everything is in the narrative perhaps with footnotes and references. But, especially if doing quantitative work getting a feel for what belongs in $Text as opposed to being extract into attributes, links, etc. (or in both) is another useful aspect of learning the tool.

The forum is, I think useful in this regard. Tinderbox users, often new, arrive with problems and preconceptions. Discussion of the problem and how to approach it often ends up with one of more solutions offered—often as a TBX—and these threads/files, if unwittingly dig into the above. Does the envisaged approach to the task make sense, is the final view/export possible or sensible in Tinderbox but might an alternate route be possible, are the most appropriate tools/views being used, etc.?

It might be that files/discussions in past threads might be a seed for the examples being made.

†. I don’t mean formal qualitative work, with its theatre of ‘method’ (fill in the boxes exactly correctly or else…), but real exploratory qualitative work, measuring emergent knowledge.

It would be beneficial to delve into this further. Honestly, I’ve not found the case for 1. Even the simplest items, e.g., managing my social media posts with Tinderbox, have given me amazing benefits.

As @mwra suggests, Tinderbox is a toolbox for thinking and publishing.

Here is a list of work I get done in Tinderbox:

Manage my notes, there are four types:

  • Scratch ideas that I may throw away (NOTE: most of my scratch notes are in Tinderbox)
  • Writing, posts, articles, whitepapers, books (inc. textbooks), reports, classes.
  • Resources (a.k.a. Zettles), notes that I atomize and reuse across projects (I take special care to set naming and reuse structures to make it possible to copy relevant notes and processes across TBX files easily)
  • Functional/Backstage notes Tinderbox uses to function, including my configuration notes.

The key is to keep content, structure, and appearance as separate as possible, i.e., use action code and templates to produce my output. Leverage the views to help me with my thinking. It is important to consider your input and outputs and how the various pieces will come together. I have Tinderbox automate repetitive tasks or tasks prone to human error, e.g., exploding a list of 200 questions generated by ChatGP after reviewing a bookchapter. I also use several complimentary tools. As great as Tinderbox is, it does not do everything.

Type of work I with Tinderbox

Outside of my writing, I use Tinderbox to:

  1. Manage the cases I teach, assignments, exams, quiz questions, announcements, lecture secure, syllabus, and grading…this way I’m in control of my material, and I don’t lose it to the school’s CMS
  2. Resume management
  3. Sales Pipeline
  4. Project management and oversight
  5. Multi-day offsite meeting note management
  6. Teaching
  7. Tracking my own learning and courses
  8. Overseeing an archive of resource notes: images, quotes, statistics, regulations, companies, people, etc.
  9. Manage events: conference, webinar, workshops, keynotes, etc.
  10. Play, have fun, learn something new

Really, you can manage nearly any type of work with Tinderbox. I find that, more often than not, I failed to maintain discipline—I failed myself rather than the tool failing me.

I think what puts people off is they see it as an all-or-none proposition rather than a tool for incremental formalization of one’s thoughts and contributions. Also, it can be off-putting to learn new syntaxes and languages, e.g., RegEx, HTML, CSS, etc.

Anyway, maybe a good conversation for this weekend’s meetup.

2 Likes