Formerly “Words | Web | Woad” | Current home of "Simone Parrish Photography" and "How to Cook Apples" | culinary musings, knowledge management, odd bits of beauty, general nerdliness
I might put more about the whole tradition here, but right now I just need a link to the song…
Tree-Hunting Song
Tune = Polly in the Holly (trad.) | Words by Anna-Marie York and Simone Parrish, circa 2001
*Oh the Oak rests in the winter time to marshal his strength
But the Holly stays bright and green the whole winter’s length
Green branches in the winter promise life to be,
and the first tree in the greenwood, it was the holly.
Holly! Holly! Oh the first tree in the greenwood, it was the holly. Continue reading Yule Tree Family Tradition
Note: I’m making this post sticky (hence the “Featured” flag), because it’s the one I edit the most often. I’ll keep adding new ones at the top as I find them. There is nothing erudite here; these just all cracked me up. (Also this post is PG-13, or maybe R, depending on how you feel about the existence of a certain word that begins with c. And I don’t mean “corgi”.)
February 23, 2023: Backlogging! Corgi-sized meteor as heavy as 4 baby elephants hit Texas – NASA. h/t to Jenn Huff, who posted this to Facebook with the comment “Today in ‘Americans will use any unit of measurement other than metric’!” Another news outlet said this meteor was “only about two feet wide but weighed as much as seven full kegs of beer”.
From 2018 but posting Sept. 2, 2021: Why the Heck Do So Many Koalas Have Chlamydia?I didn’t see this story in 2018. I saw it just now because it came up on a thread from the (highly recommended) Facebook group “Crap wildlife photography.”
“It’s a garden, not a stained-glass window” is a metaphor I came up with to talk about knowledge management, content management, ongoing curation and database management, and iterative design processes. I think I started using it about ten years ago. A few different people have recently told me how much this concept has helped them, so I’m putting it here on my blog for intellectual property/attribution reasons.[1]
Many ideas in U.S. corporate culture come from industry and manufacturing. Objects and processes in a factory, mine, or construction site have to be perfect in some ways—they have to fit in a specific slot and happen at a specific time, or other things will go badly wrong. This interchangeable parts/assembly line/standardized processes way of thinking has created efficiencies and opportunities for expansion beyond the wildest dreams of the artisanal producer.
But this industrial mindset also (in my opinion) warps our way of thinking about other kinds of work. In my professional milieu (focused mostly on knowledge management and web content strategy), many things can’t ever be perfect, or finished. I used to find this frustrating. I like finishing things: making something polished, and checking it off a list. I used to feel panicked letting something go when I knew it could be better.
We also live in a time when few things are made to last. A stained-glass window in a Gothic cathedral had to be as perfect as possible; it was made to last a thousand years, unchanging. I used to feel the same way about my work—that it would be a permanent reflection of me, or of a moment captured out of time.
Then the metaphor came to me: These are gardens, not stained-glass windows.
This metaphor encapsulates and summarizes a lot of other thinking—from “the perfect is the enemy of the good”; to artistic or aesthetic traditions that acknowledge transience and imperfection (Arachne’s hubris, wabi-sabi, the apocryphal-but-appealing imperfect stitch/Persian flaw/humility square); to Seth Godin’s “Ship!” concept.
Recognizing that you need to constantly change things doesn’t mean you failed in the first place. A garden is never “finished.” You plan, and you plant, and you tend. Dig up weeds, or leave them be. Carry water, or wait for rain. Become the mother of mantises. Some things grow better than you expected (make a bigger bed for them, next year). Sometimes things don’t go well; your soil has an invisible pathogen, and all the cantaloupe plants turn to rot. A tree next door dies, or your neighbor builds a new fence, and the light in your garden changes. You have an early hot spell, and all your lettuce bolts and turns bitter. Maybe the people you are feeding suddenly become allergic to eggplant, or decide they don’t want to see another turnip until next year.
So, a small practical example: You worked hard on that user manual. You took every function into account, organized it in a way that made sense to you, and crafted the instructions carefully. But your work is not done: Watch to see how (or whether!) people use the manual. What challenges can they still not solve themselves? What questions do they still ask? Check your readability; are your sentences too complicated? Do you use words they don’t know? Check your information architecture: Do people not understand your category names or chapter titles? Maybe they don’t want a 300-page reference book at all. Maybe they want a “Top Five Tips” sheet.
Another: You made a website. People used to come to the homepage and click through the navigation to find what they are looking for; more often now they come to a specific page from Google or Facebook. They look at one thing, and they leave. Do you try to force them through the homepage—make them come through the garden gate, walk past the things they don’t want, dig for the things they do? No. You change your page aliasing, check your metadata, submit a sitemap for crawling, make sure your site search works well. Or you push new posts straight to social media. This delivers your goods to the people who want them—sometimes before they are even inside the gate—wherever they are coming from.
Your audience changes, or they want something different. The environment changes. Information changes. You can—and must—adjust to those changes. That’s how we tend the garden of human knowledge. That is the process that creates culture. It’s what knowledge management, writ large, is for. It’s how we survive, thrive, and build a better world.
[1] Like everything else on this blog, I’m offering the metaphor under a Creative Commons Attribution-Noncommercial-Sharealike license. This is my metaphor, my meme, my idea. You can use it, if you want, as long as you say it it is mine, and you’re not trying to make money from it. More details on my Fine Print page. [Go back up to reference point.]
[Edit: I’m updating this post on May 1, 2017, significantly enough that I’m going to re-post it with a new publication date.]
I wrote this in January 1999, as a nursery rhyme for my then-baby godson Aiden. Its tune and structure are borrowed from “Green Grow the Rushes-O,” which dates back to at least the mid-1800s. It’s traditionally sung as a call and response, but that’s totally optional. I sing it by myself all the time.
I posted the lyrics as a Facebook note in May 2013, and moved them to this blog in August 2016. At this re-writing, in April-May 2017, I am grieving Aiden’s untimely death. In considering whether I could sing this at his memorial gathering on April 29, 2017, I was worried about choking up. I started experimenting with Garage Band so I could sing along with myself to get the song back in working vocal memory. During a day of practice in the car, I realized I was often dropping in little bits of harmony, so I recorded those as a separate track. (Edit, December 2023: When I recorded this I thought I would do a more-polished version with more harmony lines, but that hasn’t happened and it has been more than six years so odds are pretty slim.) Continue reading Children’s Song: Green Grows the Mistletoe
This piece was originally published as a three-part note on Facebook, March 21-26, 2014. Facebook’s “Memories” feature helpfully reminded me of the anniversary in 2017, prompting me to post it here.
Part One
Where does this tale begin? The struggle with the Terpenoids only lasted a day, but the roots of the story go much deeper. I can’t tell every tale starting with the universe that came before it, though. It would help if you knew me, a little—that I approach cooking from sacred and social and scientific perspectives, and that for me it’s only partly about eating, and feeding others. It’s also about taking pleasure in technique, and honoring what has come before: the struggles of various collections of molecules to find joy in the processes of survival and creation. Continue reading Sassi Saucier vs the Terpenoids (Anniversary Edition)
My site description says “knowledge management, good Web content, duck confit, odd bits of beauty, general nerdliness, and the Oxford comma.”
While I *use* the Oxford comma on this blog, I am not sure I have really blogged about it, per se. My brother-in-law Seth called me on this the other day–and then a lot of people read this news story and told me it made them think of me. I’m quite proud.
I am a staunch, steadfast proponent and defender of the Oxford comma. None of the arguments against it make sense to me, when weighed against the arguments for it. I’m not going to try to convince you, though. You can do that for yourself. (Just Google “Oxford Comma” and be amazed at the nerdery and vitriol.)
Lynne Truss’ lovely Eats, Shoots & Leaves calls the comma a “grammatical sheepdog” that “tears about on the hillside of language, endlessly organising [sic] words into sensible groups and making them stay put.” Ms. Truss acknowledges the pro vs con argument and advises “There are people who embrace the Oxford comma and those who don’t, and I’ll just say this: never get between these people when drink has been taken.”
When it comes to holiday baking, I have a mission: Bake something delicious for the two vegans on my team. Bake sales and dessert buffets are sad for vegans unless someone is looking out for them. I’m a militant omnivore, but I like to take care of my people, and I like the challenge of baking without eggs or dairy products. Continue reading Sassi Saucier, Cookie Butter, and Magic Bean Water
Over the years as a writer and editor (and interrupted linguist), I’ve mellowed quite a bit. From a young age through my late 20s, I was a strict prescriptivist/pedant: “These are the rules; I am going to follow them, and I am going to get an A!” Gradually I’ve shifted toward descriptivism: “All usage is in some stage of flux; I just want to write clearly for my audience, so I can convey ideas as accurately as possible.”
But there’s one usage about which I am adamant: “Data.” Is it singular, or plural? The answer I accept is “Ask your audience.”
Here’s my argument:
(1) Are you speaking or writing Latin? “Data” is plural.
(2) Are you speaking or writing English? Ask yourself: How does my audience expect me to treat “data”?
(a) “Data” is neither singular nor plural in essence, but a mass/uncountable noun (like “furniture” or “traffic”–or “audience.”) Nevertheless,
(b) If you are writing or speaking to an audience of scientists (especially social scientists, but not computer scientists), you should use plural verbs and markers with “data”–otherwise, they will consider you unsophisticated, and possibly think less of your expertise. (I don’t think that’s a fair leap to make, but it’s a fact of life.)
(c) If you are writing or speaking to a general audience and/or computer scientists, use “data” with singular verbs and markers. Otherwise, your audience is quite likely to think you are being pretentious. (If you *want* them to think you are pretentious, have at it. Just be aware of the effect this choice can have.)
(d) If you don’t know enough about your audience to make an informed choice, rewrite the sentence to avoid having to use “data” with a marker of grammatical number.
The argument that “data” is the plural of “datum” holds no weight with me, because:
(i) I can’t remember the last time I heard “datum” (rather than “data point”) in common parlance; and, more importantly,
(ii) English is not Latin. Once English has accepted a word from another language, the grammatical rules of the root language no longer control that word. “Opera” in Latin is the plural of “opus,” but in English “opera” is most frequently used as a singular noun. Most people use “agenda” in English as a singular noun as well–“Do we have an agenda?” “Hold on, I’ll send it to you.”
(This is mostly about body painting, but if you like you can skip down to the bit about the colors you can get using woad as dye.)
Caution: Woad can cause allergic reactions and irritate eyes and other sensitive areas. Your use of any techniques or instructions herein is at your own risk. Be sensible.
TL;DR: For quick reference, here’s just my recipe: 1 packet (5g) powdered woad pigment, 2 tsp whisky, pinch of rosemary, wet-ground in a mushroom-shaped mortar and pestle. That makes a concentrate. Mix 1/2 tsp of the concentrate with another 1-2tsp of whisky to achieve your desired coverage quality. Many, many more details below. Gum arabic is optional. I’ve started but not completed some chalk experiments. Continue reading How I Woad: Using Woad for Body Painting
1. Think about your readers. Before you begin writing, put yourself in a reader’s shoes. People read on the Web to find solutions to problems, get information, be entertained, or be moved or supported emotionally. What are you trying to convey? Is it useful, interesting, motivating, or energizing? Make reading worth their time.
2. Be careful with jargon. Jargon and abbreviations can be useful shortcuts with the right audience. With the wrong audience, they are actively alienating. Jargon and abbreviations can also be hard to translate, if translation is a concern. Use plain language and spell out your abbreviations.
Jargon tangent: I recently did an informal survey asking friends how they felt about “thought leadership”—an expression I hear quite a bit in my professional sphere. 78 people responded. 10% felt neutral or grudgingly positive. The other 90% felt negative: They found it pretentious, confusing, or Orwellian.
Write Well
“Writing well” is a huge undertaking —far beyond the scope of this tip sheet. The tips below are the pieces of “writing well” that are particularly applicable to writing for the Web. They can be especially helpful for people who are used to writing in a more academic or specifically-professional style (e.g., reports to a particular funder, papers for a known group of experts).
3. Find your own voice, and use it. Within whatever style guide you might be held to, express your own ideas or build an argument from your own perspective, but in words your readers will understand. Imagine reading your piece out loud: Does it sound like you? If you read it aloud, would people listen? Readers recognize authenticity when they see it.
4. Condense your sentences. Check your writing with a readability tool (like this one). Keep your average sentence length down (15–20 words is a reasonable range, depending on your target audience). Vary your sentences — break up long sentences with short ones. (Write music.) Even people who have the patience to read a 40-word sentence on paper may give up after 20 words on the Web.
5. Watch the details. This includes proper grammar and punctuation. Check your spelling. Small mistakes will distract some readers from your ideas. (Imagine grit in a salad. Is the salad still good?) Also, double-check sources and quotations. It’s tempting to illustrate your point with a supporting aphorism from a famous person, or a quote from a colleague—but make sure they really said it. A misattributed or inaccurate quotation can be a big embarrassment.
Web Writing Specifics
6. Don’t paste from Word. Word is full of background formatting code that does not play well with most websites. If you wrote your piece in Word, copy and paste it into a plain-text editor (like Notepad or TextEdit) before putting it into a website content management system (CMS). Yes, you’ll have to re-do all your links—but that’s much less work than cleaning out incompatible code. If you must write in Word, and you’ll be sending your work to a content manager for publishing, it’s polite to include the URLs of any embedded links, so the content manager can reconstruct the links when s/he strips out the formatting.
7. Be conscious of length. This tip used to be “Keep it brief.” Experts used to recommend 300 to 700 words as a guideline for blog posts . Over the past ten years, with the rise of Twitter and mobile, very short-form writing became popular — but then there was a backlash in favor of more in-depth writing. It’s not uncommon now to see online posts of 3,000-5,000 words. If you think your piece needs to be longer, consider turning it into a series or a different type of publication. It’s a good idea to put an estimated read time at the top, and/or a summary of the key message of your post (some people call this the “TL;DR” — “too long, didn’t read”). Here’s a tool that calculates read time.
8. Make your piece scannable.Most people don’t actually read on the web. They skim through a page, looking for headings, keywords, and bullets that interest them. Would a reader still learn something from your piece if they read only the first few words, and skimmed through the highlights?
9. Make links meaningful. Links stand out — so make them mean something. A link to a video of a cute kid racing an otter is more meaningful and scannable than one that says to click here — even though they both go to https://www.youtube.com/watch?v=n9APqLA2YKs. (Don’t use bare URLs like that on a web page; they are not meaningful to humans, and they clutter things up.) Meaningful links are also an accessibility issue for people with disabilities. Many people with impaired vision use a “screen reader”—a device or app that literally reads website text aloud. In some modes, the screen reader only reads header and link text — it skips all the paragraph text until the user asks for a paragraph. Imagine the difference between hearing “a recent study about injectable contraceptives…today’s statement by the World Health Organization”, versus hearing “click here … here … click here.”
10. Write a good title. If someone were to try to find your piece with a search engine, what would they search for? Are those words in your title? Are they in your piece? Search engines tend to rate things more highly if the words in your title are also in your text. (Read my colleague Liz Futrell’s To Click or Not to Click: The Art of a Good Title.)