The Written Word
Follow the brush
Never change the technology
v0.crap
One brick
More that can be done
To deprecate beauty itself
iA writer
Scientific writing
What Mick Southern taught me was both the imperative to and the means of writing scientific prose—“if it’s not published it’s not done,” as a later adviser put it. Mock showed me that the rather dry technical requirements of scientific writing did not necessarily mean that elegance, humor, and even wit need be excluded from the scientists’ products.
Information remix
Effective writing stems from intelligently connecting the dots between the concepts you understand and can articulate. It stands to reason, then, that in order to generate more creativity you must not only add to a knowledge base, but deepen and expand the number of connections within the totality of the network. By establishing and explicitly mapping your knowledge, you allow yourself the freedom to remix information. You will often find that solutions come from previously unsuspected fields or topics—proving to be analogous in some shape or form.
Angkorwatification
Applied to a blog, angkorwatification is a sort of textual equivalent of rewilding. You have a base layer of traditional blog posts that is essentially complete in the sense of having created, over time, an idea space with a clear identity, and a more or less deliberately conceived architecture to it. And you have a secondary organic growth layer that is patiently but relentlessly rewilding the first, inorganic one. That second layer also emerges from the mind of the blogger of course, but does so via surrender to brain entropy rather than via writerly intentions disciplining the flow of words.
Narrative codes
The idea, as both sides' counsel worked it out, is that you will regard features like shifting p.o.v.s, structural fragmentation, willed incongruities, & c. as simply the modern literary analogs of 'Once upon a time...' or 'Far, far away, there once dwelt...' or any of the other traditional devices that signaled the reader that what was under way was fiction and should be processed accordingly. For as everyone knows, whether consciously or not, there's always a kind of unspoken contract between a book's author and its reader; and the terms of this contract always depend on certain codes and gestures that the author deploys in order to signal the reader what kind of book it is, i.e., whether it's made up vs. true. And these codes are important, because the subliminal contract for nonfiction is very different from the one for fiction.
Stories
I know nothing of stories.
Poppies
I write, erase, rewrite,
erase again, and then
a poppy blooms.Imagining her
I think this is perhaps the hardest part of writing—of “generously imagining her”—continuously, unendingly. And this is the only difference between good and bad writing in the end. That doesn’t mean it’s easy (being kind is often the hardest thing to do) and of course I mention this not to lecture anyone but only as a keepsake and as a reminder for myself.
Like normal people
Abe: What's wrong with our hands?
Aaron: What do you mean?
Abe: Why can't we write like normal people?
Aaron: I don't know...I can see the letters. I know what they should look like, I just can't get my hand to make them.
Thinking in terms of outputs
In our use of digital and analogue filing tools, we classify information through folders. An article about railway construction gets filed under ‘infrastructure’ or ‘transport’. In Evernote we tag it with ‘rail’ or ‘construction’. This is thinking like a librarian and not like a writer. We are classifying the information as an input. The reason you take notes as a writer is to produce content. It makes sense, then, to take notes in line with this goal.
Traditional filing like this tends to fail when you attempt to write your content. You are stuck trying to figure out which categories will be relevant for your proposal, paper or blog post. Interesting writing often comes from connecting separate fields through a common idea. By revealing the common denominator. By unifying two seemingly-contradictory ideas. How can you possibly achieve this if you’re looking in the same category for your information? The categories simply do not fulfil the function required by the writer.
The notes you take and indeed, the way you process information, should be with a specific project or idea in mind. You must classify information in terms of its outputs. When you take notes on a book, think about how this could apply to a specific idea you had or how it argues against a paper you read last week. The premise is that you should be organising by context and always trying to connect the dots between the content you're consuming.
Babble and Prune
For those who read and listen much more than they speak (guilty), an overly-strict Prune filter is applied to their writing; when these people go to write something of their own, their minds don’t produce thoughts nearly as “coherent, witty or wise as their hyper-developed Prune filter is used to processing”.
Hence, my dilemma and an opportunity to break out of this trap. I recognised that if I attempted to write at the quality I was used to reading at, first time every time, my brain would promptly grind to a halt—like trying to brainstorm with a group that laughs at your suggestions.
Several Short Sentences About Writing
A Book by Verlyn KlinkenborgHere, in short, is what I want to tell you.
Know what each sentence says,
What it doesn't say,
And what it implies.
Of these, the hardest is knowing what each sentence actually says.The Elements of Style
A Book by William Strunk Jr. & E.B. White- Choose a suitable design and hold to it
- Make the paragraph the unit of composition
- Use the active voice
- Put statements in positive form
- Specific, definite, concrete
You're Probably Using the Wrong Dictionary
An Essay by James SomersThe Sense of Style
A Book by Steven PinkerDownsides of the internet
An EssayThe type of nitpicking behavior that I mentioned earlier, is especially problematic since it often causes the loss of writer’s authenticity. With time, these criticisms cause one of the following:
- The writer stops publishing their work.
- The writer stops reading comments and minds their own business.
- The writer learns their lesson and sands off their edges in order to fit better in the society du jour.
The larger the writer’s audience, the more likely it is for the writer to pick the last option and tone down their voice. You can experience this first hand when reading the essays of prominent bloggers. Their early work is usually interesting and fun to read, which naturally brought a large audience to their doors. But the more the show goes on, the more they will waffle around the topic, since with a large enough audience every thought will be misunderstood and nitpicked mercilessly.
only the questions
A Tool by Clive ThompsonI’ve been watching how writers use questions lately, and thought: Hmmm, it’d be cool to see only the questions in a piece of prose.
gwern.net
A Website by Gwern BranwenThe goal of these pages is not to be a model of concision, maximizing entertainment value per word, or to preach to a choir by elegantly repeating a conclusion. Rather, I am attempting to explain things to my future self, who is intelligent and interested, but has forgotten. What I am doing is explaining why I decided what I did to myself and noting down everything I found interesting about it for future reference. I hope my other readers, whomever they may be, might find the topic as interesting as I found it, and the essay useful or at least entertaining–but the intended audience is my future self.
Some thoughts on writing
An Essay by Dan LuuBesides being unlikely to work for you even if someone is able to describe what makes their writing tick, most advice is written by people who don't understand how their writing works. This may be difficult to see for writing if you haven't spent a lot of time analyzing writing, but it's easy to see this is true if you've taken a bunch of dance classes or had sports instruction that isn't from a very good coach. If you watch, for example, the median dance instructor and listen to their instructions, you'll see that their instructions are quite different from what they actually do. People who listen and follow instructions instead of attempting to copy what the instructor is doing will end up doing the thing completely wrong. Most writing advice similarly fails to capture what's important.
The surprising effectiveness of writing and rewriting
An Article by Matt Webb- The act of writing the first draft creates new “essential data” that feeds the imagination and makes possible figuring out the second draft.
- Or: In your head, ideas expand until they max out “working memory” – and it’s only be externalising them in the written word that you have capacity to iterate them.
- Or: Good writing necessarily takes multiple edits, and the act of writing and act of rewriting are sufficiently different that performing both simultaneously is like rubbing your tummy and patting your head.
Stream on
An Article by Simon CollisonA primary motivation for creating my Stream was the paralysing sense that a blog post needed appropriate length and weight. Since switching to Kirby, there’s relatively little friction to posting, but there’s definite friction in evaluating a post’s worth to the reader. I’d think to myself, “I’d like to write something about that, but I’ll have to come up with all sorts of extra stuff and dressing, and it’ll take all afternoon.”
And so, I was increasingly aware that I was letting many interesting or essential thoughts go undocumented, allowing them to drift from memory, or exist only on social media, likely to one day evaporate. I’ve become more and more interested in the human desire to document, and it’s something I’ve always valued, so I needed to find a solution that I could entirely control and own. That solution was my Stream.
Things Learned Blogging
An Article by Jim NielsenEschew anything beyond writing the content of a post. No art direction. No social media imagery. No comments. No webmentions. No analytics...Imagine stripping away everything in the way of writing until the only thing staring you back in the face is a blinking cursor and an empty text file. That’ll force you to think about writing.
...[And] write for you, not for others. And if you can’t think of what to “write”, document something for yourself and call it writing.
If there’s one thing I’ve learned about the mystery of blogging, it’s that the stuff you think nobody will read ends up with way more reach than anything you write thinking it will be popular.
So write about what you want, not what you think others want, and the words will spill out.
Writing, Briefly
An Article by Paul GrahamAs for how to write well, here's the short version:
Write a bad version 1 as fast as you can;
rewrite it over and over;
if you can't get started, tell someone what you plan to write about, then write down what you said;
expect 80% of the ideas in an essay to happen after you start writing it;
start writing when you think of the first sentence;
write about stuff you like;
learn to recognize the approach of an ending, and when one appears, grab it.Writing and Speaking
An Essay by Paul GrahamBeing a really good speaker is not merely orthogonal to having good ideas, but in many ways pushes you in the opposite direction...there's a tradeoff between smoothness and ideas. All the time you spend practicing a talk, you could instead spend making it better.
Forget the computer — here’s why you should write and design by hand
An Article by Herbert LuiIn the middle of the 2000s, the designers at creative consultancy Landor installed Adobe Photoshop on their computers and started using it. General manager Antonio Marazza tells author David Sax:
“Overnight, the quality of their designs seemed to decline. After a few months of this, Landor’s Milan office gave all their designers Moleskine notebooks, and banned the use of Photoshop during the first week’s work on a project. The idea was to let their initial ideas freely blossom on paper, without the inherent bias of the software, before transferring them to the computer later for fine-tuning. It was so successful, this policy remains in place today.”
Blogging with Version Control
An Article by Will DarwinI’ve been musing for a while now on the way blog posts are typically presented—in reverse chronological order. This format has never truly made sense and does not reflect the way good writing and thinking happens.
...The main issue with the ‘pile’ system is that this post is eventually buried beneath more recent pieces of writing; there is no incentive for revisiting or updating the work. Even worse, if an author does decide to unearth the piece and make some major changes, those who read the original piece are not made aware of these alterations. The sorting order is static.
Don't Write the Tedious Thing
An Article by Maud NewtonUgh, now I have to write this boring part, I would think. I would spend a few days in active rebellion against this directive that I imagined the book was imposing.
Then I would realize: this is my book! There are no rules! I can write it however I want! Also, I would think, if I’m bored by something that I believe I need to write, the reader undoubtedly will be too, if not because the subject is inherently boring, then because I myself find it so unbearably tedious to imagine discussing it for five pages. Often as not, I would remember some aspect of the subject that deeply interested me, something a little outside the way it’s usually perceived or written about. Then I would meditate on that, and soon I would be scribbling notes from an increasingly excited place until I found a way forward. A form of beginner’s mind.
Waiting around to write
A Quote by Gertrude SteinIf you write a half hour a day it makes a lot of writing year by year. To be sure all day and every day you are waiting around to write that half hour a day.
The most important thing you do
An Article by Austin KleonFor the writer, your career will be the result of whatever piece you’re working on right now, and the piece you’re working on right now will be the result of whatever sentence you’re working on right now.
Poison sniffers
An Article by Austin KleonChristopher Johnson says “prescriptivists” or “Cute Curmudgeons” — people who are interested in only policing usage and grammar rules — are “linguistic poison sniffers.” They turn language into “a source of potential embarrassment rather than pleasure.”
Johnson sees his job as getting people to love and appreciate language by being curious about and paying attention to “what makes language delicious.”
This reminded of Olivia Laing’s distinction between identifying poison and finding nourishment.
Everywhere you look these days, there are lots of poison sniffers, but very few cooking a delicious meal…
Almanacs and cyclical time
An Article by Austin KleonI am fascinated by the Farmer’s Almanac, and the “Planting by the Moon” guide in particular, which has advice such as: “Root crops that can be planted now will yield well.” “Good days for killing weeds.” “Good days for transplanting.” “Barren days. Do no planting.”
I think it’d be funny to make up an almanac for writers and artists, one that emphasized the never-ending, repetitive work of the craft.
Open Transclude for Networked Writing
An Essay by Toby ShorinDon't get me wrong
An Article by Austin KleonNo phrase makes me want to stop reading more. “Don’t get me wrong” is usually a tell — a kind of backpedaling that sets off an internal alarm and suggests I’m a) reading a hyperbolic argument (which, admittedly, describes the majority of online writing these days) or b) that the writer is just lazy. Either way, when I see “don’t get me wrong,” I start to suspect I’m reading a piece of writing that might not be worth my time.
If you find yourself using “don’t get me wrong,” I have a suggestion: Delete the phrase and rewrite what came before it so I don’t get you wrong.
Writing. By Tully Hansen
A Website by Tully HansenWrite Simply
An Essay by Paul GrahamI try to write using ordinary words and simple sentences.
That kind of writing is easier to read, and the easier something is to read, the more deeply readers will engage with it. The less energy they expend on your prose, the more they'll have left for your ideas.
Telescopic Text
A Websitetelescopictext.org is an experimental tool for creating expanding texts. It is based on telescopictext.com.
Re: Pointing at things
An Article by Robin RendleI think I’ve been darting around this question for a while now:
...I think we’ve all been taught to write in a style that forgets the reader entirely. My English degree taught me, incentivized me in fact, to write poorly with this sort of obfuscatory language, “nevertheless...”, “in this essay I will set out to...” etc.
All that stuff is me pointing at me, pointing at a thing. But we should just get out of the way of the thing we’re pointing at!
The Age of the Essay
An Essay by Paul GrahamPolitics and the English Language
An Essay by George Orwell- Never use a metaphor, simile or other figure of speech which you are used to seeing in print.
- Never use a long word where a short one will do.
- If it is possible to cut a word out, always cut it out.
- Never use the passive where you can use the active.
- Never use a foreign phrase, a scientific word or a jargon word if you can think of an everyday English equivalent.
- Break any of these rules sooner than say anything outright barbarous.
Who the fuck is Guy Debord?
An Article by Robin RendleZettelkasten
A Tool by Niklas LuhmannA zettelkasten consists of many individual notes with ideas and other short pieces of information that are taken down as they occur or are acquired. The notes are numbered hierarchically, so that new notes may be inserted at the appropriate place, and contain metadata to allow the note-taker to associate notes with each other. For example, notes may contain tags that describe key aspects of the note, and they may reference other notes. The numbering, metadata, format and structure of the notes is subject to variation depending on the specific method employed.
Fragments of time
A Quote by Italo CalvinoLong novels written today are perhaps a contradiction: the dimension of time has been shattered, we cannot live or think except in fragments of time each of which goes off along its own trajectory and immediately disappears.
Koya Bound
A Book by Craig ModKoya-san — home to esoteric Buddhism — is the name of a sacred basin eight hundred meters high and surrounded by eight mountains. It is roughly one hundred kilometers of trails north from the Kumano Hongu Taisha shrine in Wakayama, Japan. Though the name of the basin is often incorrectly translated as Mt. Koya in English, Mt. Koya is only one of the eight peaks, and is remote from the central cluster of temples.
We walked towards Koya-san, but we did not touch Mt. Koya.
Every Website is an Essay
An Article by Robin Rendle"Every website that’s made me oooo and aaahhh lately has been of a special kind; they’re written and designed like essays. There’s an argument, a playfulness in the way that they’re not so much selling me something as they are trying to convince me of the thing. They use words and type and color in a way that makes me sit up and listen.
And I think that framing our work in this way lets us web designers explore exciting new possibilities. Instead of throwing a big carousel on the page and being done with it, thinking about making a website like an essay encourages us to focus on the tough questions. We need an introduction, we need to provide evidence for our statements, we need a conclusion, etc. This way we don’t have to get so caught up in the same old patterns that we’ve tried again and again in our work.
And by treating web design like an essay, we can be weird with the design. We can establish a distinct voice and make it sound like an honest-to-goodness human being wrote it, too."
How to Think About Notes
An Article by Will DarwinHigh Cadence Thoughs
A Website by Ryan Dawidjan[I] personally wish blogging was more about peeking behind the curtain into one's mind rather than shipping a polished contained unit.
I am an explorer
A Quote by C.S. LewisI do not sit down at my desk to put into in verse something that is already clear in my mind. If it were clear in my mind I would have no incentive or need to write about it. I am an explorer…We do not write in order to be understood, we write in order to understand.
Eyes on the ground
A Quote by Akira KurosawaWhen you go mountain climbing, the first thing you’re told is not to look at the peak but to keep your eyes on the ground as you climb. You just keep climbing patiently one step at a time. If you keep looking at the top, you’ll get frustrated. I think writing is similar. You need to get used to the task of writing. You must make an effort to learn to regard it not as something painful but as routine.
Seeing With Fresh Eyes
Meaning
Space
Data
Truth
The problem with trees
Many systems are organized hierarchically. The CERNDOC documentation system is an example, as is the Unix file system, and the VMS/HELP system. A tree has the practical advantage of giving every node a unique name. However, it does not allow the system to model the real world. For example, in a hierarchical HELP system such as VMS/HELP, one often gets to a lead on a tree such as:
HELP COMPILER SOURCE_FORMAT PRAGMAS DEFAULTS
only to find a reference to another leaf: Please see
HELP COMPILER COMMAND OPTIONS DEFAULTS PRAGMAS
and it is necessary to leave the system and re-enter it. What was needed was a link from one node to another, because in this case the information was not naturally organized into a tree.
Content-responsive space
Content-responsive spaces in text can be as meaningful as spaces and line breaks in computer code, poetry, math, dialogues, cartoons.
For 1500 years, printed text has used grids indifferent/hostile to meaning. Content-responsive grids are better than imperious grid-possessed layouts. To clarify and intensity meaning, authors and editors can remodel relations between spaces and words...insisting on control of line breaks by authors (who, after all, know the content).
Personal annotations
Yehudi Menuhin, a great violinist, marked up a score for Bach's Sonata No. 2 for Solo Violin. Penciled annotations show real-time performance strategies. To outsiders, insider markups appear chaotic and cryptic, but these personal annotations are for Menuhin's eyes, the only eyes that matter. All can learn from this useful workaday grid strategy: a relevant and intense data layer can become a coherent substrate scaffold upon which to overlay additional information. Maps do this all day long.
What excellence is
Learn what excellence is, how to identify it...This is not a big reading assignment – excellence is scarce, lognormal, long-tailed. Acting on this knowledge is liberating, freeing oneself from vast piles of triviality, knock-offs, petty connoisseurship, over-publishing, and the short-sighted, trendy, greedy. Excellence is long-term knowledge, even forever knowledge.
Excellence, like good taste, is perhaps a universal quality. Analytical thinking is about the relationship between evidence and conclusions, and is fundamental to all empirical work, regardless of field, discipline, specialty. Thus it is possible at times to assess credibility of nonfiction work without being a content expert. Thinking eyes may well have an eye for excellence, regardless of field or discipline.
Sentences and words do not exist by themselves
Sentences and words do not exist by themselves, but have natural, inevitable, unavoidable interactions with their surrounding spaces, words, and other sentences. Sentences are not independent of their spatial context, and interactions can create meanings and harms. Sentences survive content-indifferent and content-hostile spacings, but surviving is not thriving. Text space should not be owned and governed by generic productions grids, which make for convenient production but inconvenient meaning. Space can and should be content-responsive, actively contributing to meaning – forever practices in poetry, maps, math, computer code, comics, theater/movie scrips, posters. Subtle visual spacing differentiates and clarifies sentences, and meaning becomes more consequential, memorable, retrievable.
Central-axis text
Central-axis provides a clear signal of the next line, so that readers and speakers don't have to search on the left margin, sometimes accidentally skipping down a line. Ragged-left typography is used for dialogue in novels and scripts. In central-axis, each line is activated at both left and right margins – unlike squared-off conventional text. Readers/speakers are aware of the length of the next line at both its beginning and end. That knowledge may also help readers detect the pace and rhythm of the words, as in reading poetry aloud.
Idiosyncratic paragraphs
Text-only paragraphs differ from one another only in their words. All the words are typographically the same – typeface, spacings, line-lengths piled up into long deep columns. Systematic regularity of text paragraphs is universally inconvenient for readers, who are unable to find and read once against a specific string of words in previously-read paragraphs. All readers have encountered this problem in essays, articles, novels, news reports. Idiosyncratic paragraphs assist memory and retrieval by readers, by uniquely activating the relevant neural substrates for retaining visual memories. Nearly every paragraph in this book is deliberately unique.
No more LittleDataGraphics
Small data sets should be shown directly...LittleDataGraphics (pie charts, bar charts) translate and encode data into areas and colors. Viewers must then mentally translate codes back into numbers. These codes are unique to the local sets of data graphics, and do not repay learning. Instead, just directly show numbers as numbers. No more LittleDataGraphics. Data visualizations are at their best when there is so much data that the only way to see it...is to see it.
An immense wordy diagram
In ~1560 Ettore Ausonia, a polymath with interests from mathematics to mirror-making, constructed an immense wordy diagram depicting reflections from concave spherical mirrors. Then, between 1592 and 1601, while teaching at the University of Padua, Galileo made this handwritten copy of the diagram, which was fortunate since Ausonio's original has since gone missing. Three helpful architectures for the off-the-grid sentences are deployed – word trees, stacklists, annotated linking lines.
Stacklists
Stacklists organize and clarify complex material in 2-space. Readers read more slowly, and that's good: to think, look again, and connect words vertically within each stack and horizontally between stacks. Instead of polyphony, conventional inline lists are a freight train of words along a one-way narrow track, making it difficult to identify which words belong to which list and to link and compare elements within and between lists.
Observe data collection at the moment of measurement
See, observe, learn how data are collected at moment and place of measurement. "You never learn more about a process than when you directly observe how data are actually measured," said Cuthbert Daniel, a superb applied statistician. See with fresh eyes. Walk around what you want to learn about. Talk to those who do measurements. See how numbers came to be.
Do those measuring know the desired answer? Are those measuring skilled, alert, honest, biased, incompetent, sloppy, tired and emotional?...Artifacts and errors in measurements measured? How are outliers adjudicated?
46 data quality issues in spreadsheets
Outcomes decide
High levels of U.S. patient satisfaction are mainly associated with hospitality (greeters at the door, empathetic staff, comfortable rooms) – but also with more treatments, high costs, and substantially higher mortality even after adjusting for baseline health and comorbidities. Several plausible stories explain these big n and replicated observational findings. Whatever the case, post-treatment patient satisfaction/gratitude does not measure whether a treatment works or not. Patient outcomes decide.
Which half?
One day when I was a junior medical student, a very important Boston surgeon visited the school and delivered a great treatise on a large number of patients who had undergone successful operations for vascular reconstruction. At the end of the lecture, a young student at the back of the room timidly asked, "Do you have any controls?" Well the great surgeon drew himself up to his full height, hit the desk, and said, "Do you mean did I not operate on half of the patients?" The hall grew very quiet then. The voice at the back of the room hesitantly replied, "Yes, that's what I had in mind." Then the visitor's fist really came down as he thundered, "Of course not. That would have doomed half of them to their death!" God, it was quiet then, and one could scarcely hear the small voice ask, "Which half?"
Good annotation
Information displays should be annotated, combining words, images, graphics, whatever it takes to describe and explain something. Annotation calls out and explains information and, at the same time, explains to viewers how to read data displays. Good annotation is like a knowledgeable expert/teacher at the viewer's side pointing and saying, "Now see how this works with that, how this might explain that..."
Signs seen and unseen
Direct instructions at point of need may encourage writers and programmers to divert diversions. Or not, because signs are seen only a few times before becoming unseen.
What is the strongest visual element?
Preparing to write the novel Catch 22, Joseph Heller composed a storyboard, a 2-dimensional list with 3,650 words arrayed in 34 × 21 = 714 interacting cells. Rows are ordered in time, and each row records when each character does what. Some cell entries are erased. It took 7 years to complete the novel's 758-page typescript.
The Catch 22 plotchart works better upon replacing optically noisy grids with ghost grids. Lightness of framing lines creates soft boundaries to maintain order and also allows words to spill across cells naturally...More generally, ask of information displays and interfaces, "What is the strongest visual element?" The correct answer is not "grid lines".
Your only language is vision
To see with fresh, uninstructed eyes and an open mind requires a deliberate, self-aware act by the observer. Abstract artworks represent themselves and should be first viewed for themselves. When looking at outdoor abstract pieces, concentrate initially on the unique optical experience produced by the artworks. See as the artist saw when making the piece.
A focus on optical experience does not deny stories, it postpones them. Viewing an artwork may evoke interesting narratives – or just tedious artchat recalling similar art or artists, concocting playful tales, realizing how scrap metal was repurposed into art, making judgments about the artist's intentions or character, or contemplating an artwork's provenance, price, politics. Let the artwork stand on its own. Walk around fast and slow, be still, look and see from
up down sideways close afar above below
, enjoy the multiplicity ofsilhouettes shadows dapples clouds airspaces sun earth glowing
. Your only language is vision.Lists consist of whatever it takes
Lists consist of whatever it takes – nouns, proper nouns, verbs, graphics, images, numbers.
...In lists, spaces have meaning, locating elements in relation to other elements. Lists are often free and independent from conventional rules of stylesheets / grammar / typography / punctuation. Lists also help us escape from the personal internalized mash-up stylesheets of every writer and reader – a continuous low-level background buzz checking to see if word usage, spelling, punctuation, grammar are 'correct'. Lists are all content – about the substance contained, not the container. An empirical theory here for reasoning about lists includes
selection of list items
list quality and completeness
comparing list models
comparing list architecturesNo wonder you think it's complicated
We were very proud of our user interface and the fact that we had a way to browse 16,000 (!!) pages of documentation on a CD-ROM. But browsing the hierarchy felt a little complicated to us.
So we asked Tufte to come in and have a look, and were hoping perhaps for a pat on the head or some free advice. He played with our AnswerBook for 90 seconds, turned around, pronounced his review:
"Dr. Spock's Baby and Child Care is a best-selling owner's manual for the most complicated 'product' imaginable – and it has only 2 levels of headings. You have 8 levels of hierarchy and I haven't stopped counting yet. No wonder you think it's complicated."
Verb List
Documents vs. decks
Decks are easier to prepare than documents, however. Documents require coherence, thinking, sentences. But convenience in preparing decks harms the content and the audience. Optimizing presenter convenience is selfish, lazy, and worst of all, replaces thinking.
Books are meant to be used
During most of the course students have their books open, either to read or to follow along. Students are encouraged to annotate the books: "Books are meant to be used. Dog-ear the pages, mark them up, put notes in the spacious margins."
Learning via teaching
The course material changes 15% each year, as the book currently in progress becomes part of the course years before it is finally published. I detect incoherencies and mistakes in the new material while teaching. This leads to refinements or even throwing stuff out from the forthcoming book. A good way to learn about something is to teach it.
Self-publishing, self-exemplifying
I sought to design [my first book] so as to make it self-exemplifying – that is, the physical object itself would reflect the intellectual principles advanced in the book. Publishers seemed appalled at the prospect that an author might govern design. Consequently I decided to self-publish the book.
...[Howard Gralla and I] spent the summer in his studio laying out the book, page by page. We integrated graphics into the text, sometimes in the middle of sentences, eliminating the usual segregation of text and image – one of the ideas Visual Display advocated.
My view on self-publishing was to go all out, to make the best and most elegant and wonderful book possible, without compromise. Otherwise, why do it? The next 4 books were financed by the previous books. I have never written a grant application.
A history of content and sources
Not all that many readers go to the back matter and look up the source for a single sentence. But the back matter can also be read as ordinary text, revealing a history of content and sources. And images and illustrations from the book in the back matter create a lovely visual/verbal summary quilt of the entire book, enjoyed by all.