Structure, Documentation, and Poetry

At work I've introduced a new method for storing the content for procedural documents (i.e. tutorials/how-to guides/etc,) that is more structured. Rather than just writing a tutorial in a conventional way, we capture the steps in a specific structure that we use to generate the content in a specific way. The structure lets us do cool things with the presentation that would be hard to do well otherwise and help us focus theses kinds of documents on the core procedural or sequence-based nature of these documents.…

Keep reading

Practicing

In response to my Knitting Practices post, on Facebook my father commented "The word "practice" is apt. Is there an influence from yoga?" The answer is obviously "yes," though the route is somewhat indirect and travels through a story about programming. Stick with it for a little while. Generators and Python Memory Efficiency I was talking with a dancing friend about memory efficiency in Python programs, particularly with regards to loops and the range() function.…

Keep reading

The First Ankle Sock

I recently finished my first knitting project after my [[return to knitting|/knitting/a-knitting-practice/]]: a pair of ankle socks in a medium (for socks) weight yarn. The socks are plain and I'm pleased with the result, but there were some unexpected parts of the project, and some useful lessons: These Aren't The Socks You Meant To Make For the most part I'm interested in knitting pretty plain socks in plain (solid) yarn: probably even undated yarn that I can soak in tea or henna post-knitting.…

Keep reading

The Perfect Rib

I knit socks on four (5 inch) double pointed needles, these days from the cuff down, and I enjoy socks with some amount of ribbing at the cuff. Seems reasonable. I also tend to have two other restrictions: Each needle should have the same number of stitches. In the ribbing, each needle should begin with a knit stitch and end with a purl stitch. This somewhat constrains the possibilities. Also given a preference for rubbings that are biased towards knit stitches, I tend to veto options that might otherwise be workable.…

Keep reading

A Knitting Practice

I've not done much knitting for the last year or so. I have a sweater in progress (a cardigan,) and I have an in progress scarf thing, and that's about it. Or was. I enjoy knitting, and find it both relaxing (the rhythm) and stimulating (the meditative aspects, the project planning and design). And I'm pretty good at it. I've been knitting (mostly on) for the last 10 years (or so,) and am very technically competent (I think.…

Keep reading

2013 Reflections

I have a hard time passing up a significant calendar event as an opportunity to reflect and synthesize past experiences. Having said that, while I had a pretty good year, it was not a year of big changes. There were a lot of pretty interesting and fun smaller changes and developments in my world and my projects in the last year. In no particular order: This was the year that I went from being "someone who tinkers on code" to being someone who can write code when the situation calls for it.…

Keep reading

Static Site Compiler Design Notes

For a year or more I've been playing with the idea of writing my own static site generator. I've been producing websites using static site generators for the last 4 or 5 years. For an overwhelming majority of cases, static generation is the right modality; however, there are some significant ways in which the tool chain is not mature. I've been working on an initial pass at a better kind of static site generator, which is a ways away from being "production quality," but the initial idea is in place, so I feel comfortable discussing some of the details.…

Keep reading