May 042014
 

A few months ago I wrote a series of posts about revising my Tinderbox course planning file. (The sidebar links to a good starting place.) When that series ended, I’d settled on a new strategy for writing materials and using links to navigate, but my course maps were either auto-generated or simply rough groupings of linked materials.

Neither was very useful, but I was hopeful that as I worked, a sense of how to organize the material would emerge and that the software would be flexible enough to handle the changes. And it turns out that an organization did emerge and that Tinderbox never broke a sweat as I whipped things into shape.

So this is my revised course map:

Revised Map

The changes are extensive and represent a huge departure from the maps I was using last year. But I couldn’t be more happy with the results. So in the next few paragraphs I’d like to explain how to read what you see. In a subsequent post, I’ll explain the tools I used to actually build the map.

Navigation Buttons

The map breaks into two sections. On the left is a column of dark, wide notes with large text sitting upon a red container. The notes in this column function as buttons that drop me into my wiki-view.  I selected which notes to make buttons by looking for notes that emerged as a link hub in my rough early maps.

For example, the note “Required Texts” contains a basic description of every text I will assign or reference in the course along with a summary explanation of how each will be used. Text titles are always an in-text link to that book or film’s note. The text of that note contains links to other notes in turn. So by double-clicking “Required Texts,” I can navigate to information about any of my readings with only a click or two. The same holds for the other buttons.

“Daily Schedule” operates slightly differently, and so I set it off by colouring it black. This button opens a journal note. After every class, I write a very brief description of what we did. The journal serves as my record of what was accomplished and assigned rather than what was planned. Every reading, lecture, activity or assignment mentioned in the “Daily Schedule” is linked in-text to the relevant note. So by the end of term, this note will provide a textual version of my schedule map (which, naturally, is contained in the map view of the “Daily Schedule” note).

Finally, the red container at the bottom of the column contains notes for each of my individual students. These notes are never accessed through wiki view. So to access student notes I drop into this container and work in a separate map (or call up an outline view).

Unit Adornments

The second section of the map sits to the right of the column of buttons. It contains three adornments laid out in a row, one for each unit of the course. I use these adornments to plan the content of the course independent of the schedule of the classes. (This screen cap was taken as I was beginning the second unit, so the second and third units are not yet complete.)

Using prototypes, I have distinguished between four different types of materials.

  • Blue notes with round edges are primary texts that are either assigned or discussed directly. A blue border indicates a print text; a green border, a film text. The notes that have been darkened by changing their pattern to lines are texts held in reserve as alternates.
  • Yellow notes are graded work. A purple border indicates the assignment involves students creating and drafting pages on the course web site.
  • Grey circular notes are mini-lectures. A red border identifies history lectures that build upon each other independent of other course materials.
  • Green notes with pointed edges are in-class activities that involve a formal assignment sheet or complex instructions.

The map shows only one type of link. These links are visible on the map as arrows leading from one note to another and indicate that a reading, lecture or activity will be used directly in graded work and so must be completed before it is assigned. All other link types are invisible.

Finally, overlapping notes indicate when lectures use primary texts as examples or incorporate activities.

Oral Presentations

Managing oral presentations is always difficult. For this class, I laid out the presentation texts in order on an adornment below the units. I then created aliases of student notes and lined them up under the text they were speaking on. This simple set-up lets me to know who’s presenting on what at a glance and allows me to make adjustments when needed with little hassle or up-keep. This reduces my workload so much that this section of the map is just about my favourite.

A Info Rich Map

Finally, what may not be immediately obvious in all of this is that each of the notes visible on this map contains note texts accessible by double-clicking the map object.

Double-click on a lecture and you’ll find my speaking notes and, probably, a link to the keynote file I’ve prepared. Double-click on graded work and you’ll find the assignment sheet. If the assignment will be completed on the web, those instructions will be in mark-up, ready to be copy-pasted into the text field of the edit page on the course wiki. Most importantly, every single one of these notes will contain at least one in-text link, which means that from any point, I can navigate to all my other notes independent of my map or outline.

So I think my revised course map is incredibly useful, and I’m very happy with it. In the next few days I will post an explanation of the nuts-and-bolts of how I actually built it. That post’s not done yet but it’s shaping up to be a love letter to the Attributes and Inspector Panes. So stay tuned.

 May 4, 2014  Hypertext, Teaching Tagged with: ,
Feb 112014
 

In my original template, dates and deadlines, kinds of material and their topics, and everything else I needed to know about a note was indicated and organized visually in map view using nested containers, colours  screen position, badges, borders and even pattern overlays. This worked well but it also made my maps rigid rather than creative spaces. Every visual element was assigned with little room left to experiment. I’m trying to change this with my template revision my displacing some of this visual information from the map onto other attributes.

Flat Maps

Because of how I’ve generated notes using my “wiki view,” my maps start out autogenerated, unadorned and monochromatic.

Autogenerated Map

These maps are also oddly beautiful.

To begin working with these maps, I simply grouped notes loosely to get a basic sense of flow. This arrangement was ad hoc and changed based on what I was looking at. As I’ve worked and my notes have multiplied, this map has become a challenge to work with and to “see”–but this confusion is useful and generative. So I’ve resisted eliminating it by simply “tidying up” the map.

Flat Maps

A very early map with few notes or links.

The one container I have created so far is called “Daily Schedule” and I use its map view to plan activities that have clear start dates or deadlines. But even here I have resisted nesting containers and have tried to move information into non-map attributes: my schedule is now built with overlapping adornments and on-add actions set the $StartDate attribute automatically for aliases dropped on an adornment.

Adornment Schedule

Same old grid but now flattened into overlapping adornments

Having working $StartDate data allows me to use timelines, something I couldn’t do before and have barely begun experimenting with.

Boolean Attributes & Agents

In addition to $StartDate, I have created a series of user attributes to carry the information I’d previously stashed in note colour, badges, etcFor example, material types are now stored in $Story, $Film, or $SecondarySource attributes. $OralPresentations and $Assigned attributes criss-cross these and distinguish materials selected for use from those that were simply considered.

All of these attributes are boolean, which is another departure. In my previous template I used mostly sets. For example, I had a $MaterialType attribute that was first a string and then a set. But typos were a hassle and selecting from (or remembering) multiple names for the types I was using was too. Having multiple yes/no attributes (one per type) is easier for me to maintain and keep consistent.

These new boolean attributes also make it easier for me to build agents on-the-fly. Do I need a schedule of oral presentations? Then I create an agent that searches for $OralPresentation as “true” and set it to sort by $StartDate. Am I building a bibliography of supplementary readings and screenings? I create an agent that searches for $Story, $Film and $SecondarySource as “true” and $OralPresentation and $Assigned as “false.”

These agents have a simple syntax and take only moments to create. As a result, I can make them up as I need them even if I need them only for a short time.

Link Types on a Map

Finally, the links on my top-level map have become extensive and they read primarily in terms of density. But I have been thinking about what else they might be made to tell me if I thought of them in terms of link types.

What I’ve realized is that many of these links are simply for navigation, and I don’t need to see them in map view. Others are navigational and also informational insofar as they indicate kinds of materials and the relationships between them. It seems there would be value in assigning these different links different types and then setting them to display differently on the map. Navigation links could be hidden, for example, but links to required and supplementary materials might be presented in different colours.

And in a Note Text…

If link types can be useful in map view, it also seems they ought to be able to differentiate relations between materials in note texts as well. For example, right now link-text colour simply tells me what I’ve clicked on. Knowing instead that a green link leads to an assignment and a blue link leads to reading notes could be very useful. But I suppose this depends on whether I could set up rules or agents to make link-text colour representative of link type. And I don’t know how to do that or even if it’s possible…

The End (for now)

And so this post ends with ideas and speculation and I take that as a sign that my description of my template revision has caught up with my practice and that it’s time to wrap up the series. When the term is further along and I know more about how things have gone, I’ll give an update.

 February 11, 2014  Hypertext, Teaching Tagged with: , ,
Feb 052014
 

I’ve been thinking about the mismatch between how revolutionary my “wiki view” seems to me and how completely insignificant it appears when I reread my description of it in my last post. When I reread, my take-away is: so I’ve started writing notes…in Tinderbox…”The Tool for Notes”…and… (yawn).

So I’m wondering: what is it about my work that makes writing and navigating notes with links seem so powerful?

The answer I think lies in the way I have been using “course content” to refer to two different things. On the one hand, it is my knowledge of a field, call it literature. On the other, it is all the lectures, activities and assignments I create for my students so that they can practice skills and demonstrate knowledge. The first of these is what I teach; the second, how I teach it.

In order to organize how I teach, I need to sequence course lectures, activities, and assignments so that they fit within the time constraints of a single semester. I also need to manage and track my movement–and my students’ movement–through this sequence. My original template offers me the tools I need to do these things.

Sequence is less important when organizing what I teach. Literature is complex. It operates through language. It organizes itself aesthetically. It is a field of meaning and a history and an etc. When I organize what I teach, I create an interpretation of this complexity pitched at my students.

My “wiki view” creates a word-based system for organizing what I teach that is independent of the graphical representations of sequence that organize how I teach. It allows me to dive into and swim freely through a sea of words. And when I need a breath of sequential air, I know that I can come up to the surface and bob around in map or outline view.

This new freedom to develop what I teach in a way proper to my field is, I think, the revolution I’m feeling.

 February 5, 2014  Hypertext, Teaching Tagged with: , ,
Feb 022014
 

The roots of my course plan revision reach back to the classroom wiki project I began creating last May. As part of my early preparations for this project, I created a personal wiki to experiment with the software I’d be using and decided to populate it with course materials to get it started quickly. This got me thinking about how planning a course in my Tinderbox template was different from what course planning would look like on a wiki.

Now, it was obvious almost immediately that the wiki was too limited to do any actual course planning. But at the same time there were two real and enormous benefits that I could see in a wiki-based approach. First, the wiki forced me to focus on texts and how pieces of text lead me to other (or new) materials. Second, the wiki nurtured a mild but generative confusion as I worked. Both of these seemed worth importing back into my Tinderbox template.

So, in this post, I’ll explain how I’m rearranging my template to shift my focus to the text of my notes, and in my next, I’ll explain how (and why) I’m “breaking” my template enough to let in some confusion.

The Problem of Title-Notes

Because I worked in outline and map views in my original course planning template, many of my notes consisted of little more than the title attribute (plus whatever attributes or copy-pasted text I used to catch them later with agents). These titles needed to be short enough to be viewed on a single line or within a reasonably sized box. They were also largely static.

In practice, the titles of empty notes named or described content (lecture notes, exercises instructions, etc.) stored outside my template, often as a keynote or word processing file. Generally but not always, I linked to that external file from my note. Generally but not always, I copy-pasted the content of that file to the note on the day I taught so that it would be included in the Nakajoki view printout I brought to class.

Notes as Titles

Dig down into map view and you find a bunch of empty notes.

Notes in my Wiki

In my wiki, things worked very differently. There were no map or outline views, and page-note titles were displaced to the top of my browser window. I was forced to deal with the actual content of pages and found this confrontation with the imperfect messy details of my work inspiring.

I also found that depending on links to navigate created a pressure to state ideas and information rather than merely to name them. In principle, blank pages in the wiki were the same as blank title-notes on my outline or map views, but in practice they were not. I needed note texts with links to navigate from page to page on the wiki. A blank page was a dead-end in a way an empty note wasn’t in map or outline view. The way past these dead-ends was to add content and links, even if only provisionally, so that the blank obstacle opened up and gave me a way to move on to the rest of my materials.

Living in note texts and making them lead one to the other through links pushed me to bring materials into existence and toward maturity in a way I hadn’t been pushed to do in my original course template.

Creating “Wiki View” in Tinderbox

A primary goal of my template revision has been to create a similar immersion in note texts and a similar link-driven push to develop materials in Tinderbox. To do this, I set my old template aside, created a new file, and:

  1. switched my preferences to hide the sidebar;
  2. created a first note called home in the initial outline view and opened it;
  3. closed the initial outline view;
  4. worked out from the home page, creating and writing new notes as I need them.

This set-up recreated my wiki experience. Note titles, which were central in my original template, were here displaced to the title bar, and my note text was pushed front-and-centre. As I write material, I added links to new notes, and used these links to navigate.

Wiki View

My “Wiki View”

But It’s a Tinderbox Wiki

This set-up is not, however, simply recreation of my wiki experience. It also improves on it in two ways.

First, links in my new template open in a new window. Some might find this annoying (and tabs are coming to Tinderbox) but without the sidebars, the note window is very compact and I like seeing and working on multiple related notes simultaneously. (Multiple windows also makes linking pieces of text to other notes very easy.) More importantly, open windows can be arranged on my desktop as an ad hoc map view but with one great benefit over a regular Tinderbox map: my note texts on this map are both visible and editable.

Second, because of how Tinderbox is built, this new way of working can operate alongside all of the course planning strategies I used in my previous template. My workspace has been expanded–an entirely new “ground level” space has been created underneath the eye-in-the-sky map views–but those map views are only a hotkey way. When I’m ready to do so, all of the notes I create in wiki view can be organized into semester schedules and content groupings just as I did in the past. Which is incredible.

(What’s even more incredible is that, although I’m working in a completely new and better way, I get the sense that, if it talked, Tinderbox would say “well of course you can do that” as if it had been designed to do exactly this new thing and had been waiting all along for me to realize it.)

Next up, how I’m cultivating a bit of confusion

 February 2, 2014  Hypertext, Teaching Tagged with: , , ,
Jan 302014
 

My second stab at using a classroom wiki has launched. It’s going well so far: everyone has posted a profile and is figuring out how to use the basic mark-up.

Something that caught me off guard last time was the peculiar mix of ignorance and familiarity most students bring to an internet-based project and which tends to block them early on. This time around I have redesigned the pages providing general course materials so that they serve as models students can use when creating pages of their own. Obvious, but I didn’t think of it last time. More on the project later in the term.

As I have been getting students up and running on that site, the pipeline of posts I’d prepared on my course planning revisions has run dry. I’m working on the rest now, and they should start up again this weekend.

 January 30, 2014  Hypertext, Teaching Tagged with: , ,
Jan 272014
 

I suppose I should say something about agents before I start talking about my new course file.  

Basic Agents

In my original template, agents were as basic as basic could be and were used initially to sort student notes. By the midpoint in the semester I’d created an individual note for each student by importing an Excel spreadsheet. In the note text I’d indicate basic information about the student’s submission of assignments and my feedback on their written work. Keeping track of who had submitted drafts or participated in peer review or sought help from a tutor at the writing center had always been quite difficult. But now I was cutting and pasting fixed strings into student notes that I would then search for with agents. Tons of work was suddenly gone.

Basic Agents

A basic agent. Later agents might search for an attribute as well as some text, but seldom more than that.

Eventually I understood what attributes were.* By the end of the term, I’d begun converting some of my text strings to Boolean attributes. I’d set the default to true and then mark “false” for anyone who didn’t hand in a draft, for example. This was easier than cut and paste and tidier too.

All that said, I should admit that what I could do with agents in absolute terms was very limited. I knew no scripting or programming languages and was completely new to the concept of regular expressions. Everything I did was based on the basic syntaxes demonstrated when I selected options from the dropdown menus of the agent-creation window. By using these simple examples as models (and with some flipping through action lists in the manual and rereading some explanations in The Tinderbox Way), I figured out how to do what I needed to.

Agents and Links

I used agents to gather material without ever using them to perform actions. Partly this was because of my limited ability to write action scripts. But it also reflects what I was trying to do: I needed to schedule and categorize material by date or by connections to readings but also wanted to work with them in a way that didn’t resemble a filing cabinet or file structure. My boring basic agents cut across the hierarchy of boxes I’d built in a way I’d imagined links doing; and they confirmed that the materials dropped into boxes were in fact interconnected.

My template revision is very much about nurturing the interconnections I’ve been picking out with agents in my original template. My next post will talk about what that means and how I’m going about it.

________________________

*I “knew” what attributes were, but I associated them with fields in a database and saw them as fixed and complicated, something I had to create in anticipation of future needs. What attributes actually are “clicked” when I realized I could add and delete them at will.

 

 January 27, 2014  Hypertext, Teaching Tagged with: , ,
Jan 242014
 

As I explained in my previous post, I scheduled class time in my Tinderbox template by dropping notes (or aliases) into a class meeting’s container. I also kept related materials together in “Reading” containers. This set-up works fine–better than fine: it’s more useful than anything I’ve ever before!–but clearly I’ve become greedy, because as I’ve used  my template, I’ve decided there are things I want to work better.

Boxes within Boxes

Course content late in term is dependent upon content from early in term, and over time, I’ve realized that my template set-up obscures all connections that are not about sequence within the schedule. For example, when looking at my semester schedule map, I see whether something is “before,” “with,” or “after” something else. Colors applied with prototypes also identify four kinds of material: readings, lectures, activities, and assignments.

But when I double-click into a day’s container in map view in order to work with the notes directly, I can no longer see what came before or will come next. My schedule, which shows the progression of material across the entire term, disappears from view, and I’m left considering the day’s materials in isolation. Keeping open multiple windows with multiple views addresses this problem, especially once I realized that dropping notes and aliases between windows was problem-free. Yet, I’m not entirely happy with this solution: I want to begin with connections and organize them, but my containers make isolated material my starting point. This feels backwards.

Hopes for Links…postponed.

Linking was a more-or-less new proposition for me when I began using Tinderbox. But I’d bought into the idea that it might open up new ways of seeing my material and had built links up haphazardly as I added my content notes. I soon discovered, however, that many of the links I’d built between notes were hidden by my set-up. Links to notes within the same container show up visually on the map, but links to notes in other containers do not. Instead, they are indicated with a short arrow coming out of the lower edge of a note or going into the top edge.

Links in Map View

In-coming and out-going links to notes in other containers are indicated with small arrows above and below notes.

To see which notes are being linked to or from I could have opened a “Browse Links” window or opened the note and clicked on the link list. But most of the time I didn’t do this. I was using links hopefully rather than with purpose. And so, I seldom had a good reason to open a “Browse Link” window to see where those in-coming or out-going link arrows led. What I wanted was the link pictured so I could see what I might find out. But my containers were keeping that from happening. 

And so, linking became something I explored in other Tinderbox files built up for personal projects rather than in my course file, and course maps like the one above were largely abandoned. Now, with more experience with links under my belt, bringing links back into the planning process is the primary goal of my template revision.

My next post is about agents

 January 24, 2014  Hypertext, Teaching Tagged with: , ,
Jan 222014
 

Although I’ve written about my original course plan a bit in earlier posts, I need to review a few points so that what I want to do differently this semester will make sense. So here goes.

Mapping a Schedule

I began my course plan by duplicating my paper schedule using adornments. That was it. Adornments plus notes with titles dropped where they would happen.

Image of Adornment-based Map Schedule

A semester of class meetings in a single view

Things changed after I took my schedule-map and looked at it in outline view and realized that note-images were also manipulable note-files. (I had known this but not understood what that implied.) When I saw both views side-by-side, I suddenly realized I could organize in two independent but interconnected ways: change the materials (revise the title, add note text) and they were updated everywhere, but change their organization in the outline view and the note-images stayed in place on the map. This was major.

Outlining a Schedule

Now my outline was initially a mess: dozens of notes randomly arranged, my adornments didn’t show and I didn’t know that separators existed. So to organize my outline, I decided to create a hierarchy. This created an outline-schedule that worked like a file structure with collapsable containers.

Image of Schedule and Reading Outlines

Outline views from late in term. Early on there were fewer notes.

Next in map view, I deleted the adornments I’d used to make my map-schedule. I then sized and arranged the note-images of my new containers to replicate the layout of the adornments I’d erased.

Image of Container-based Map Schedule

Containers holding notes rather than adornments sitting under them.

In a sense this brought me back to square one: I had my map schedule back. It still offered in a complete, readable, interactive overview of my schedule for the semester. But now the flat adornments were “keyholes” looking in on rooms holding each day’s materials, and my new outline views gave me quick access to what each room contained.

Content plus Scheduling

The final big change came when I created a “Readings” container with one note for each assigned text. I then moved the note for every lecture, exercise and activity related to a text into its note making it also a container. This kept related content together in one spot. I then repopulated my outline- and map-schedules with aliases of these reading and activity notes so I knew when they would be covered.

The result

All of this led to a more-or-less fixed workspace.  I kept open two different schedule views (one in outline, one in map) and a content bundle (also in outline view) that together offered me three avenues for developing, expanding or refining my course. For big picture concerns I worked in the map view. To plan or adjust individual class meetings, I worked in outline view. I sorted out the progression of materials (or identified missing or incomplete materials that needed development) in my “Readings” window. Before each class I also printed a Nakakoji view of the day’s container and used it as speaking notes.

I tried other things as I went along, but in general terms, this is the foundation of what I worked with for the rest of that term and for the remainder of the year.

In my next post, I’ll explain two limitations I’ve found in my template.

 January 22, 2014  Hypertext, Teaching Tagged with: , ,
Jan 202014
 

A little over a year ago, I bought Mark Bernstein’s Tinderbox and began using it to plan my literature courses.

The software was flexible and useful, but there was a lot to learn and I was figuring things out as I went. I’ve written about that experience twice before: once about six weeks into it when I was just starting to get my feet under me, and again at the end of that same semester, after I realized how useful my course plan had been.

After that early success, I revised my file into a template by cleaning out everything except the basic categories, adornments and agents I would need to plan other classes. I have used it to plan all my courses since.

But now with another semester on its way and with some experience using Tinderbox in coordination with my classroom wiki project, I decided to set my template aside and to approach course planning from a new angle. I’ve been talking my way through this process in my notebooks, and it seems like a good idea to post some of my thoughts here so that I don’t lose them.

These posts will pop up slowly over the coming days. The first one reviews the template I’ve been using for a year.

 January 20, 2014  Hypertext, Teaching Tagged with: , ,