Write It Right. Knitting Tech Writing for Dummies Part I

Best Quote I Heard All Day
“The difference between the right word and the almost right word is the difference between lightning and a lightning bug.” --Mark Twain

Since I rather doubt any of the magazines would publish an article about knitting technical writing, I figured why the fuck not do it here?

As many of you know, I make my living as an IT tech writer, specializing in Software Development Life Cycle, SharePoint (a Microsoft collaborative platform), end-user guides, and a pile of other tech documentation crap.

Lately, I've been horrified at the poor quality of many knitting directions, some of which are published by well-known yarn companies and some by independent designers. Last Thursday at Stix-n-Stitches's Sit 'n' Knit night, I helped a fellow knitter translate some badly written directions. Get this--the cast-on instructions, which included placing markers between pattern repeats, were totally confusing. It was written sans asterisks, sans stitch counts, and sans much of anything other than the initial cast-on count, so she had no idea how many markers to place. In order to give her the the correct number of pattern repeats, I checked the math. Oy.

Many of you (including me) are either considering or doing your own designs and hoping to sell them. Well, if so, you'd better have your writing shit together first. This series, which I figure will run for a month, will give you some guidance. I have a very specific process that I use when designing so that my directions are comprehensible and correct. Most budding designers have wonderful ideas but no idea as to how they should be presented professionally.

Let's go!


Pre-Design Preparation
First of all, don't tell me that you "design on the needles" and re-create your directions after you've finished the piece. That's fine for swatching but not fine when you are working on a complete item, be it a sweater or a scarf. Ya gotta write and knit from the get-go. Most magazines have style guides; but you cannot go wrong using the Craft Yarn Council's Standards and Guidelines for Crochet and Knitting. This link will take you directly to their PDF. READ IT.

Step 1: Buy a notebook and use it for your sketches, charts, and directions. This will become your hard-copy Bible that you'll keep in your knitting bag while working out your design. (Of course, if you're really geeky, you can do this on your iPad or laptop but I still prefer writing with a pen to start.)

Step 2: Create a directions template for yourself in Microsoft Word, or whatever word processing app you use. Start formatting your e-file with appropriate headers. MATERIALS, GAUGE, and ABBREVIATIONS are permanent headers. And add your logo, if you have one. If you'd like, check out my Yeti Socks formatting. (If you are submitting to a magazine, you'll have to follow their publishing style, so check with your editor.)

For example, if you have designed a cardigan, you will have various section headers: BACK, FRONT (generally, you will tell your user to "reverse the right front shapings" but if one front is different than the other, you will have two Front headers), SLEEVES, FINISHING. And yes, you will have sub-headers, such as Neck Shaping.


Step 3: When you have determined what your design will be--sweater, socks, scarf, warshcloth, whatevah--choose your yarn and write down the yarn info in your Bible. Don't forget the color name(s)--if all you have on the yarn band is the color number, look it up on the web. Add this information to your electronic file.

Step 4: When you have chosen your stitch pattern(s), chart them out. I use Knit Visualizer because right now I can't afford Adobe Illustrator, which is the app that most publishers use for charting. You can also use Microsoft Excel but just for a working chart, not for final publication, EVER!

Step 5: Swatch, block, measure. Note the final gauge in your Bible and then in your e-file.


Step 6: Begin your calculations, writing them in your Bible. And for God's sake, use a calculator!!! Don't do it in your head, unless you're a fucking Einstein.


Step 7: Once you've finished your basic calculations, write your directions in your e-file and add any charts; then print the file out and put it into your Bible so that you can add notes and corrections. Don't forget to transpose written notes and corrections back into your e-file as soon as you can.

And do your sizing now! Stitch patterns, be they Fair Isle, cables, lace, or what-have-you, will dictate the sizes and their calculations, so get over that hump immediately.

So this is the very beginning. If you are working with test knitters, you want to make sure that you give them the most accurate directions possible. We'll talk about appropriate directions wording in the next entry. Here's the series' list of topics:

• Part II: Listen to the Foghorn: How to Write Clear Directions
• Part III: App Hazard--How to use computer applications for knitting directions
• Part IV: Edit, Edit, Edit, Check, Check, Check--how to edit your own directions

So tomorrow I'm off to another tech writing gig in NYC, this time down in the Village! So much better than uptown. I'll be writing the next entry in a week, on Sunday, which is a rare and handy day to so do.

Later, skanks!

Swatch That You Say?

Best Quote I Heard All Day
"Accuracy is the twin brother of honesty; inaccuracy, of dishonesty"--Nathaniel Hawthorne

Are you ever tempted to cheat on your swatch measurements?
"Oh, wait, this could be 5 stitches to an inch...let me move the tape measure a little bit."

Hopefully, you never use a tape measure to check your swatch. Why? Because tape measures do stretch out and aren't accurate enough for measuring a swatch. They're fine for body measurements and that's it.

If the garment is worked in the round, ya swatch in the round!

You do, right? Don't fucking lie to me.

Here's the swatch I'm doing for the Go Gansey! socks, in Cascade Heritage sock yarn, which is 75% superwash merino/25% nylon. Soft as shit! And yep, these are my fabulous new Signature DPs. At $45 a set, they are truly the Hope Diamonds of the needle world. I do wish that Signature would make them in #0s too.

WEBS Walkabout (not in the Aussie sense of the word)
Jerry and I took a quick trip to the Adirondacks last week but stopped in South Deerfield, MA so that he could go to Yankee Candle's flagship store and buy his aunt a present. Needless to say, I stopped at WEBS, which is just a short 11 miles south in Northampton. For shits 'n' giggles, I took a little video using my Android cellphone. I put it up on Facebook already but for those of you who ain't my FB friends, here's Mar sneaking about the store.

It is a fabulous place! New England has some of my very favorite string joints--Halcyon (Bath, ME), The Fiber Studio (Henniker, NH), Harrisville Designs (Harrisville, NH) are three that I love. I've not yet made it to Bartlettyarns in Harmony, ME, but that's next on the list. Don't waste your time going to Patternworks in Center Harbor, NH. It's really just a glorified LYS and there's nothing terribly special to buy, although the building is lovely. Jimmy and I used to vacation in Center Harbor back in the '90s because it's right on Lake Winnipesaukee, so go there for that.

I did buy a skein of off-white Cascade Heritage to make the Go Gansey! socks in both blue and off-white so that users have a traditional choice. And then I bought this:

Beautiful Madelinetosh Prairie superwash merino laceweight in the Fragrant colorway. This will become a lace scarf that I'll submit somewhere. Or sell in my Ravelry shop. Oddly, this colorway is not listed on her site but is available elsewhere. I guess they need to update the website.


Fiberality Designs
I finally got my shit together on Ravelry and set up Fiberality Designs, where you can download the Leaves of Grass and Yeti sock patterns for free, the ones that used to be available in the sidebar here. Plus, I have a couple of things for sale, too. There will be more added as I get 'em done. Of course, I'm starting a new tech writing job next week but I'll be knitting on the train, during lunch, and after work, as usual, working on the book proposal still.

So that's it for this bit. Thanks to all for your blog anniversary comments. You ARE rare and handy, ya know. Let me know if you're going to Rhinebeck, which is where I usually hook up with readers. Next entry, a couple of book reviews...and other shit, no doubt.

Later, skanks. By the way, for some half-assed Blogger reason, when I published this entry, a couple of the widgets weren't displaying data. Fuck.