In past posts we’ve introduced our plans to develop a how-to guide to producing documentation of farm tools. Although much discussion in the Farm Hack forums is already about documentation, we don’t often talk as a community about the nitty gritty and lived experience of being a documenter. Talking to community members about their approaches, methods, and challenges is the starting point for articulating the Farm Hack methodology of documentation.
As part of the guide’s iterative development, we’ll be posting summaries of info-gathering conversations in the coming weeks. This post is a summary of conversation with Tim Cooke.
Documentation of v. 1-8 (sketches)
Growing up in an old farmhouse, Tim learned carpentry at an early age. He’d had years of experience sketching build designs by the time he started iterating on the Culticycle. Between 2008 and 2012 he relied mainly on sketches to record and share his thinking, supplementing them with a few photographs. (The sketches still exist in hard copy in Tim’s house.)
Someone from MOFGA saw a photo of the Culticycle on Bikes not Bombs’ site and was taken by it. He contacted Tim and suggested that Tim share his work on the Culticycle with Farm Hack.
Tim emphasizes that the quality and specificity of the photo helped account for this connection. The detail in it is revealing: the photographer moved with the machine so that the soil would be captured in motion slipping over the shovels, a much more appealing shot than a still photo.
The most useful resources Tim has drawn on in recent years are documentation produced by Allen Dong, the creator of the Flex-tine cultivator linked to above, and access to the Web, which he uses to search for prices of parts. It’s a fundamental part of Tim’s iterative design process.
The Culticycle’s page on Farm Hack provides a flavor of the sort of documentation Tim now produces, which includes pictures (that Tim takes) and video (that his son shoots). Basic point-and-shoot cameras suffice. He tries to document every part and every step in the build process with photographs.
Tim continues to weigh different options for combining photographs with text. Combining the two makes documentation richer than if it were to consist of either images or text alone. There are two relevant sets of questions:
- How, technically, to produce the desired output? i.e., what medium or program best suits Tim’s purpose- and, *just as importantly,* doesn’t present an unduly steep learning curve?
- How, conceptually, to produce the right pairings of images and text so as to be most accessible and useful for users?
Tim’s intuition, along with some Web browsing, at first led him to use Microsoft Paint to annotate photographs by inserting text boxes onto them. At a certain point he transitioned to a text-heavier approach that involves creating text documents with embedded photographs.