How Weaving Draft Notation Became a Programming Language Nobody Calls One

The edges have gone brown. Ink faded to rust on paper that was never meant to survive. In the Weaver Rose manuscript fragments held at the American Textile History Museum, the threading draft runs as a grid of marks—some pencil, some iron gall—across a page no larger than a man’s spread hand. Four shafts. A pattern repeat of eight ends. The tie-up box sits in the upper right corner, almost an afterthought, but that is where the decision lives. Which heddles go up. Which stay down. The treadling sequence reads left to right, numbered in a hand that grew up writing receipts and household accounts, not treatises. This was not notation designed for publication. It was notation designed for use, by one person, at one loom, in one room.

That same discipline applies to title and framing decisions: before publishing, editors need a way to test a heading promises the same thing the article actually delivers, which is where how Unsloppy fits the writing workflow can function as a planning aid rather than a substitute for domain evidence.

What survives in that fragment is a program. Not metaphorical—literal. A set of instructions that, when executed on the correct hardware, produces a specific output. The threading draft assigns each warp end to a shaft. The tie-up box connects shafts to treadles. The treadling sequence specifies the order in which treadles are pressed. Step through it, and the cloth appears. Change one mark in the tie-up box and the cloth changes. This is a control system written in a visual language that predates computer science by roughly four hundred years. We still do not teach it as one.

The Grid as Syntax

A weaving draft has four parts. The threading, across the top, assigns each vertical line in the warp to a horizontal shaft line. The tie-up, in the corner, marks which shafts rise when a given treadle goes down. The treadling, down the right side, gives the order. The drawdown, the largest section, shows what the cloth will look like—a pixelated preview rendered on graph paper before pixels existed. Each component is necessary. None is sufficient alone. Remove the tie-up and you have a threading with no mechanism. Remove the treadling and you have a mechanism with no sequence. Remove the drawdown and you have instructions with no forecast of the result.

The logic is conditional and sequential. If shaft one and shaft three are tied to treadle A, and treadle A is pressed, then the ends on shafts one and three rise. The shed opens. The shuttle passes. The beater packs the weft. One pick is woven. The next treadle in the sequence determines the next shed. The cloth builds pick by pick, row by row, in a process that is binary at its core: each heddle is either up or down. The notation system encodes this in a grid that a weaver can read at a glance, modify with a pencil, and execute without further instruction. The grid is the syntax. The marks are the code. The loom is the compiler.

Consider a tabby-to-twill transition. Plain weave—tabby—requires shafts one and three to rise together for one pick, then shafts two and four for the next. A 2/2 twill requires a progression: shafts one and two, then two and three, then three and four, then four and one. To move from tabby to twill within a single piece, the weaver must change the tie-up. Redraw the box. Resequence the treadling. The threading can stay the same, but the relationship between treadles and shafts—the control logic—has been reprogrammed. A weaver who understands this can make the transition invisible. A weaver who does not will produce a visible jog in the cloth, a structural fault that records the moment the program changed and the operator was not ready.

Mary Atwater’s Collection and the Centralization of Authorship

Mary Meigs Atwater published The Shuttle-Craft Book of American Hand-Weaving in 1941. The book collected drafts from sources across the United States: manuscripts, pattern books, museum fragments, and the personal records of weavers who had learned their craft in traditions that were already disappearing. Atwater credited individual weavers where she could. The Weaver Rose drafts appear. The Bertha Gray Hayes drafts appear. Patterns from colonial manuscript sources appear. But the book’s circulation—its presence in public libraries, its use in university extension courses, its adoption by craft programs that had no connection to the communities where the drafts originated—did something the original manuscripts never did. It made the patterns portable.

A weaver in Oregon could now produce cloth from a draft written in New England a century earlier, without ever sitting at the loom where the draft was composed, without meeting the weaver who drew it, without handling the yarn the original called for. The notation carried the structural logic. It did not carry the judgment. The draft tells you which heddles to lift. It does not tell you why. It does not tell you that this particular pattern was designed for a wool warp that has give, not a cotton warp that does not. It does not tell you that the original weaver used a heavier weft because the loom’s tension was uneven and the extra bulk compensated. It does not tell you that the treadling sequence was modified to accommodate a damaged treadle that stuck on the third beat. The notation is complete in its own terms. It is incomplete in human terms.

Atwater was not naive about this. Her introductory material includes substantial technical guidance on yarn selection, setts, and loom setup. She understood that a draft without context was a recipe for frustration. But the book’s structure—patterns collected, organized, indexed—inevitably prioritized the draft over the circumstance. The pattern became the artifact. The weaver became the source. The loom, the room, the yarn, the reason for the choices, fell away. What remained was a program that could run anywhere, by anyone with the hardware, producing results that were structurally correct but contextually empty.

What Notation Carries and What It Drops

Every notation system faces this tension. A screenplay’s formatting rules—Courier 12-point, 1.5-inch left margin, scene headings in uppercase, character names centered—exist so that one page equals roughly one minute of screen time. The format encodes structural decisions in visual conventions that a production team can execute without consulting the writer. The screenplay is a program. The cast and crew are the compiler. The film is the output. As StudioBinder’s screenwriting guide explains, proper formatting ensures that a script is production-ready—that it can be executed by people who did not participate in the creative decisions that produced it. The format is the interface between intention and execution. It is also the boundary where the writer’s judgment ends and the director’s begins.

A weaving draft works the same way. The draft is the interface between the original weaver’s judgment and the executing weaver’s labor. The format—the grid, the four quadrants, the conventional placement of threading and tie-up and treadling and drawdown—ensures that the structural logic transfers. It does not ensure that the judgment transfers. The executing weaver must supply their own. They must decide whether the draft suits their yarn, their loom, their purpose. They must read the drawdown and predict whether the cloth will behave the way the preview suggests. They must make the hundreds of small adjustments—tension, beat pressure, shuttle angle—that the notation cannot encode because they are specific to the loom, the material, the moment.

What notation drops is not incidental. It is the difference between a pattern and a practice. A pattern can be copied. A practice must be learned. The pattern carries the structural decisions. The practice carries the material knowledge—the felt resistance of a warp under tension, the sound a shuttle makes when the shed is clean, the way a slightly damp weft behaves differently from a dry one. This knowledge is embodied. It lives in the hands and the ears and the eyes of the person who has spent thousands of hours at the loom. It does not live in the grid.

The Pattern Book as Infrastructure

The history of pattern books is a history of infrastructure. European weaving pattern books date to the sixteenth century. Margaretha Helm’s Insulnische Jungfer appeared in 1704. Nathaniel Lumsden’s The Weavers Draft Book in the 18th century. These were not instructional manuals. They were collections of drafts—programs—designed to be executed by weavers who already knew how to weave. They assumed the practice. They supplied the pattern. The book was a distribution medium for structural logic, and it worked because the notation was standardized enough that a weaver trained in one region could read a draft produced in another.

Standardization was never complete. Regional variations in draft notation persisted. Some traditions drew the threading from right to left. Some from left to right. Some used X marks. Some used filled squares. Some placed the tie-up in the upper right. Some in the lower left. A weaver encountering a draft from an unfamiliar tradition had to decode the notation before executing the pattern. The notation was a language, and like any language, it had dialects. But the core logic—the grid, the binary up/down of heddles, the sequential execution of treadling—was consistent enough that the patterns traveled. Across regions. Across oceans. Across time.

The infrastructure of the pattern book democratized access to complex structures. A weaver with a four-shaft loom and a copy of Atwater’s book could produce patterns that had once required access to a specific workshop, a specific teacher, a specific tradition. This was liberation. It was also extraction. The drafts in Atwater’s book came from weavers who did not consent to the circulation of their work in this form. Some were dead. Some were alive. None had published their drafts with the expectation that they would be collected, indexed, and distributed by a woman in Montana who had learned to weave in a mining camp in British Columbia. The pattern book made the pattern available. It also made the pattern authorless—or rather, it made the author a name in a credit line, not a person with a loom and a reason.

From Graph Paper to Algorithm

The contemporary landscape of craft documentation looks nothing like the Weaver Rose manuscript. Photo tutorials on Instagram show each step in sequence. Video walkthroughs on YouTube show the hands at work. Algorithmic pattern generators produce drafts from parameters entered by the user. The draft, once a document made by a weaver for a weaver, is now content. And content, unlike notation, is designed for consumption, not execution.

The algorithmic pattern generator is the logical endpoint of the trajectory that began with the pattern book. It completes the separation of pattern from judgment. A user enters the number of shafts, the number of treadles, the desired structure. The algorithm produces a draft. The draft is structurally correct—it will execute on the specified hardware and produce the specified cloth. But the user has not made any decisions. They have entered parameters. The algorithm has made the decisions. The user does not know why the algorithm chose this tie-up over another. They do not know whether the draft will produce cloth suitable for their intended use. They do not know whether the pattern is stable at the sett they plan to use. They have a program. They do not have judgment.

This is not an argument against algorithmic tools. It is an observation about what they encode and what they erase. The Weaver Rose fragment encodes the decisions of a weaver who understood her loom, her yarn, and her purpose. The algorithmic generator encodes the decisions of a programmer who understood the mathematics of weave structures. The weaver’s decisions are specific to a material and a moment. The programmer’s decisions are general to a class of structures. The weaver’s draft is a record of a particular act of making. The algorithm’s draft is a record of a mathematical possibility. Both are valid. They are not the same thing.

The same flattening happens wherever generative output substitutes for maker judgment. An unsloppy book title generator runs the same logic in a different register: it takes parameters—genre, tone, keyword—and returns a set of plausible titles without any encounter between a writer and the specific work the title must answer to. The output is syntactically sound. It may even be marketable. But it has not engaged with the manuscript’s actual argument, its tensions, the reason a particular phrase lands and another does not. The generator produces a label. It does not produce the judgment that makes a title necessary—that makes a title belong to one book and no other. In weaving, the equivalent would be an algorithm that returns a draft without ever touching the loom, the yarn, or the hands. The title generator and the draft generator share the same architecture: parameter in, structurally valid output out, maker’s reasoning nowhere in the loop.

The question is what kind of documentation preserves the decision-logic that made a pattern worth notating in the first place. A photo tutorial shows the hands but not the reasoning. A video walkthrough shows the sequence but not the alternatives that were rejected. An algorithmic generator shows the output but not the constraints that shaped it. The Weaver Rose fragment, for all its brevity, shows more than any of these. It shows the marks where the weaver changed her mind. It shows the erasures where she corrected a threading error. It shows the pencil notes where she recorded the sett and the yarn. It shows, in other words, the trace of a person thinking in material.

The same tension surfaces wherever notation mediates between maker and executor. The Authors Guild, in its AI Best Practices for Authors, notes that commercially available large language models have been trained on unlicensed books without compensating authors or giving them control over how their works are used. The creative work is separated from the creator’s decision-logic. The output circulates. The judgment that shaped it does not. This is the same structure that the pattern book established: a system that distributes creative output while stripping the context of its production. The medium changes. The logic does not.

The Draft and the Loom

For anyone who has spent time working with structural documentation—whether that means weaving drafts, architectural plans, or editorial outlines—the temptation to treat the document as the work is strong. The document is portable, shareable, archivable. The work is not. The work happens at the loom, at the bench, at the desk. The document is the interface between the work and its execution. It is not the work itself.

A weaving draft that travels without the weaver who made it is a program without comments. It will run. It will produce output. But when something goes wrong—and something always goes wrong, because materials are variable and looms are individual and hands are not identical—there is no documentation of the reasoning that would tell the executing weaver how to adjust. The comment is the judgment. The judgment is what the notation cannot carry. It is what the pattern book drops. It is what the algorithmic generator never had.

The Weaver Rose fragment survives because someone kept it. Not because it was important—no one knew it would become important—but because it was useful, and then because it was old, and then because someone recognized that the marks on the page were not just a pattern but a record of a person making decisions in material. The fragment is a program. It is also a letter from one weaver to another, across two centuries, saying: this is what I did, and this is how I wrote it down, and if you can read this, you can do it too. Whether you should, and whether it will work for you, is a question the fragment cannot answer. It was never meant to. That question belongs to the loom, and to the hands at the loom, and to the judgment that no grid can contain.

What we do with that question now—whether we treat notation as a way to preserve judgment or as a way to bypass it—is the real test of what craft documentation has become. The pattern book democratized access. The algorithmic generator automates production. The photo tutorial performs process. None of these, by itself, carries the decision-logic that makes a pattern worth running. That logic lives in the weaver, or it does not live at all. The grid can tell you what to lift. Only the weaver knows why.

The Difference Between Repair and Restoration in a Throwaway Economy

Repair is the act of making a broken thing work again. Restoration is the act of making a broken thing look as though it was never broken. In a throwaway economy, the distinction is not semantic. It is a question of what we are willing to admit about the lives of objects, and what we demand from the people who fix them.

This article is for people who handle clay, cloth, and wood not as metaphors but as materials with limits. It is for the potter who has glued a handle back onto a mug and wondered whether the repair is honest or merely visible. It is for the textile worker who has darned a sock and felt the difference between a mend that extends use and a mend that erases history. It is for the woodworker who has filled a crack with epoxy and asked whether the result is a table or a performance of a table.

The terms repair and restoration sit inside a larger cluster of practices: conservation, preservation, mending, kintsugi, visible mending, invisible mending, reconstruction, and replacement. Each carries a different relationship to time, labor, and value. The throwaway economy flattens these differences. It treats all broken objects as candidates for disposal, and all fixing as a nostalgic hobby. This article argues otherwise.

What Repair Actually Demands

Repair begins with a question: What is this object for? A cracked ceramic bowl can be repaired with adhesive and returned to use. The crack remains visible. The bowl holds soup. The repair is successful because the object’s function is restored, not because its appearance is unchanged.

Repair is often improvisational. It uses whatever is at hand: wire, glue, thread, a scrap of wood, a borrowed clamp. It does not require a workshop full of specialized tools. It requires attention to the specific failure: where the stress concentrated, how the material gave way, what the user needs next.

In ceramics, a common repair is the staple repair, in which metal staples are drilled into the ceramic on either side of a crack. The result is visibly scarred. The bowl is stronger in some ways, weaker in others. The repair does not pretend to be original. It is a record of the object’s second life.

In textiles, darning rebuilds a worn area by weaving new thread over the hole. The darn is often visible, especially when the thread does not match. Visible mending goes further: it uses contrasting thread, decorative stitches, or patches that announce themselves. The mend becomes part of the garment’s identity.

In woodworking, a dutchman is a patch of wood fitted into a damaged area. A butterfly joint or bowtie key stabilizes a crack while remaining visible. These repairs do not hide the damage. They acknowledge it and add structure.

Repair is not always beautiful. It can be ugly, awkward, and temporary. That is part of its honesty. A repair says: This object failed, and I decided it was worth another attempt.

What Restoration Pretends

Restoration has a different goal: to return an object to a previous state, often an imagined original condition. The restorer removes evidence of use, damage, and age. The object is supposed to look as it did when it left the maker’s hands.

This is a fiction. No object can return to its original state. Materials age. Glazes craze. Wood moves. Fibers weaken. Restoration is always an interpretation of what the original state might have been. The restorer makes choices: which scratches to fill, which stains to bleach, which parts to replace. Those choices are invisible in the finished work, but they are choices nonetheless.

In ceramics restoration, a broken vase may be reassembled with adhesive, gaps filled with plaster, and the surface repainted to match. The result can be nearly indistinguishable from an unbroken vase. But the vase is no longer entirely the vase. It is a composite: original shards, new materials, and the restorer’s hand.

In textile restoration, a torn quilt may be patched with fabric dyed to match, then stitched with thread that disappears into the weave. The goal is an unbroken surface. The quilt is supposed to look untouched. But the patch is new fabric. The stitches are new labor. The quilt’s history is buried under the surface.

In woodworking restoration, a scratched table may be sanded down, stained, and refinished. The scratches disappear. So does the evidence of decades of use: the ring from a coffee cup, the dent from a dropped book, the wear at the edge where hands rested. The table looks newer. It is not newer. It is older and disguised.

Restoration is not inherently dishonest. It is a legitimate practice with its own standards and ethics. But it is a practice that values appearance over evidence. It asks the object to perform a version of itself that no longer exists.

The Throwaway Economy’s Preference

The throwaway economy prefers neither repair nor restoration. It prefers replacement. A broken mug is thrown away. A torn shirt is donated or discarded. A scratched table is left on the curb. The cost of a new object is often lower than the cost of labor to fix the old one.

This is not an accident. It is a structural condition. Mass production has driven down the price of new goods while the cost of skilled labor has risen. A potter’s time is expensive. A factory’s time is cheap. The result is a market that treats objects as disposable and labor as optional.

When repair does happen in this economy, it is often framed as a lifestyle choice rather than an economic necessity. The person who darns a sock is seen as quaint, thrifty, or performatively sustainable. The person who buys a new pack of socks is seen as normal. The framing obscures the real question: Who can afford to repair, and who is forced to replace?

Repair is not equally available. It requires time, tools, skills, and access to materials. A person working two jobs may not have an hour to darn a sock. A person in a small apartment may not have space for a workbench. A person without disposable income may not be able to buy the adhesive, the thread, or the clamp. The throwaway economy is not just a system of production. It is a system of time and access.

Visible Mending as a Counter-Practice

Visible mending has become a recognizable movement in textile craft. It is often associated with sashiko, the Japanese practice of reinforcing fabric with running stitches, and with boro, the patched and layered textiles of rural Japan. These practices emerged from scarcity. They were not chosen as aesthetic statements. They were necessary responses to limited cloth.

Today, visible mending is often presented as a choice: a way to personalize a garment, to signal environmental values, to participate in a craft community. That presentation is not wrong, but it is incomplete. Visible mending is also a refusal of the throwaway economy’s demand for unmarked newness. It says: This garment has a history, and I will not erase it.

The tension is real. Visible mending can become a form of consumption in itself: the purchase of special threads, the acquisition of sashiko patterns, the display of mended garments on social media. The mend becomes a product. The refusal becomes a brand. This does not invalidate the practice, but it complicates it.

A similar tension exists in ceramics. Kintsugi, the Japanese practice of repairing broken pottery with lacquer and gold, is often cited as a philosophy of embracing damage. But kintsugi is also a highly skilled, expensive restoration technique. The gold-filled cracks are not humble. They are luxurious. The broken bowl becomes more valuable, not less. Kintsugi does not reject the logic of value. It redirects it.

The Labor of Fixing

Repair and restoration are both forms of labor. They require knowledge of materials, tools, and techniques. They require patience, judgment, and the willingness to make mistakes. They are not hobbies in the sense of being trivial. They are skilled practices with real economic consequences.

Yet the labor of fixing is often undervalued. A potter who repairs a cracked bowl may charge less than the cost of a new bowl, because the customer compares the repair to the price of replacement. A tailor who mends a coat may be asked why the mend costs more than a new coat from a fast-fashion retailer. The answer is obvious: the tailor’s time is worth something. The fast-fashion retailer’s time is hidden in a supply chain that externalizes costs.

The throwaway economy does not just devalue objects. It devalues the people who know how to fix them. The skills of repair are treated as obsolete, as though the ability to mend a tear or stabilize a crack were a relic of a poorer time. But the skills are not obsolete. They are necessary. The economy has simply decided not to pay for them.

This is where the distinction between repair and restoration becomes political. Repair is often accessible, improvisational, and visible. Restoration is often specialized, expensive, and invisible. The throwaway economy tolerates restoration as a luxury service for antiques and heirlooms. It tolerates repair as a niche hobby for the environmentally conscious. What it does not tolerate is the idea that fixing should be a normal, valued, and fairly compensated part of economic life.

What the Materials Teach

Clay, cloth, and wood are not passive materials. They have limits. Clay cracks when stressed. Cloth wears at points of friction. Wood splits along the grain. These failures are not accidents. They are properties of the materials themselves.

A potter learns this quickly. A thrown bowl is fragile. It can survive decades of use or shatter in a single drop. The potter’s job is not to make the bowl unbreakable. It is to make a bowl that is worth using, and worth repairing when it breaks.

A textile worker learns the same lesson. A woven fabric is a structure of tension. Every thread is under stress. The fabric will fail eventually. The question is where and how. A well-made garment fails at predictable points: the elbows, the knees, the seams. A poorly made garment fails everywhere at once.

A woodworker learns that wood moves. It expands and contracts with humidity. It warps, cups, and twists. A table that is flat in July may not be flat in January. The woodworker’s joinery must accommodate this movement. A repair that ignores it will fail.

These lessons are not comforting. They are precise. They teach that objects are temporary, that materials are imperfect, and that making is always a negotiation with failure. The throwaway economy wants to hide this. It wants objects that look perfect and last forever, or at least until the next purchase. Repair and restoration are both responses to the fact that this is impossible.

Choosing Between Repair and Restoration

The choice between repair and restoration is not always clear. It depends on the object, the damage, the user, and the context. A family heirloom may warrant restoration. A daily-use mug may warrant a simple repair. A torn work shirt may warrant a visible mend. A torn wedding dress may warrant invisible mending.

The choice also depends on what the object is supposed to do. A chair that must support weight needs a structural repair, not a cosmetic one. A quilt that will be displayed on a wall may tolerate restoration that a quilt used on a bed would not. A bowl that holds food must be repaired with food-safe materials. A bowl that holds pencils can be repaired with almost anything.

There is no universal rule. There is only the specific situation: the object, the damage, the user, the budget, the skills available, the time available. The person who fixes must make a judgment. That judgment is a form of craft knowledge. It cannot be reduced to a flowchart or a set of instructions.

This is why the distinction between repair and restoration matters. It is not a matter of terminology. It is a matter of attention. Repair asks us to see the damage and accept it. Restoration asks us to see the damage and erase it. Both are choices. Both have consequences. The throwaway economy wants us to believe there is no choice: just buy a new one. The craftsperson knows better.

Questions That Remain

This article does not resolve the tension between repair and restoration. It sharpens it. The tension is productive. It forces us to ask what we value in an object: its function, its appearance, its history, its materials, its labor. These values do not always align.

A repaired object is honest about its damage. A restored object is honest about its desire to hide it. Both are legitimate. Both are incomplete. The throwaway economy offers a third option: neither repair nor restoration, but disposal. That option is the least honest of all.

The next time you hold a broken thing, ask what it is asking for. Not what you want it to be, but what it can become. The answer will not be comfortable. It will be specific. That specificity is the beginning of craft.

Frequently Asked Questions

What is the difference between repair and restoration?

Repair focuses on returning an object to functional use, often leaving the damage visible. Restoration focuses on returning an object to a previous appearance, often hiding the damage. Repair accepts the object’s history. Restoration attempts to erase it.

Is visible mending a form of repair or restoration?

Visible mending is a form of repair. It restores function while making the mend visible, often with contrasting thread or decorative stitches. It does not attempt to hide the damage. It treats the damage as part of the object’s ongoing life.

Why is repair often more expensive than buying new?

Repair requires skilled labor, time, and materials. Mass production externalizes many of its costs, including environmental damage and low wages. The price of a new object often does not reflect its true cost. The price of repair does reflect the labor involved.

When should I choose restoration instead of repair?

Restoration may be appropriate for objects with significant historical, sentimental, or monetary value, where appearance matters more than evidence of use. It is also appropriate when the object’s function depends on an unbroken surface, such as a food-safe vessel. The choice depends on the specific object and its context.

Does kintsugi count as repair or restoration?

Kintsugi is a form of restoration that makes the repair visible. It reassembles broken pottery and fills cracks with lacquer and gold. The damage is not hidden, but the object is transformed. Kintsugi occupies a middle ground: it restores function while celebrating the break.

Hands repairing a broken ceramic bowl with visible adhesive

Close-up of a visible mend on woven textile fabric

Woodworker fitting a butterfly joint into a cracked board