04 Content Architecture
Content Taxonomy
- Fabric encyclopedia (~200 entries): fiber content, weight, drape, care, common uses
- Needle guide: types, sizes, fabric-to-needle compatibility matrix
- Thread guide: types, weights, fiber content, use cases
- Stitch encyclopedia (~60 stitches): description, machine settings, when to use, visual example
- Machine anatomy: parts, functions, maintenance schedules
- Glossary (~300 terms)
- Basic (~40): straight seams, hems, darts, gathering, easing, pressing
- Intermediate (~40): zippers, buttonholes, collars, sleeves, linings
- Advanced (~30): tailoring, couture finishes, leather/vinyl, stretch fabrics
Each technique includes: written steps, difficulty rating, required materials, common mistakes, and troubleshooting notes.
- Machine problems (~50 scenarios): thread breaking, skipped stitches, tension issues, noise
- Fabric problems (~30 scenarios): puckering, stretching, fraying, shifting
- Project problems (~30 scenarios): fit issues, pattern adjustments, seam failures
Structured as decision trees: symptom → probable causes → fixes ranked by likelihood. This is where the AI adds the most value — conversationally walking someone through a diagnostic process.
- Beginner (~20): pillows, tote bags, simple skirts, curtains
- Intermediate (~20): lined dresses, structured bags, home decor
- Advanced (~10): tailored jackets, evening wear, upholstery
Each includes: materials list, skill prerequisites, estimated time, step overview.
- How to read commercial patterns (major brands: Simplicity, McCall's, Butterick, Vogue)
- Taking measurements accurately
- Size selection guidance
- Common fitting adjustments (full bust, swayback, petite, tall)
Content Sourcing Strategy
Public Domain / Open License Sources
- Vintage sewing manuals (pre-1929 publications — fully public domain)
- US Patent Office illustrations of sewing machine mechanisms
- University extension service publications (USDA/land-grant sewing guides — public domain government works)
- Creative Commons licensed sewing tutorials (with attribution)
- Open educational resources from textile science programs
Original Content Generation Pipeline
This is the primary content pipeline. AI generates comprehensive technique descriptions, troubleshooting trees, and fabric profiles. Humans validate for accuracy.
Image Pipeline
- Diagrams and technical illustrations: Generate programmatically with SVG/vector tools (stitch patterns, machine diagrams, seam cross-sections)
- Fabric swatches: Photograph a reference set (~200 types) — one-time photo shoot or licensed stock imagery
- Technique step photos: Commission or source from CC-licensed creators
- Generative images: For decorative/conceptual imagery only — never for accuracy-critical content
Content Entry Format
{
"id": "FABRIC-042",
"domain": "sewing",
"category": "fabric-encyclopedia",
"title": "Jersey Knit",
"content": "Jersey knit is a single-knit fabric with a smooth face...",
"metadata": {
"difficulty": "beginner",
"related_entries": ["NEEDLE-012", "STITCH-008", "TECH-015"],
"tags": ["knit", "stretch", "t-shirt", "casual"],
"compatibility": {
"needles": ["ballpoint", "stretch", "jersey"],
"threads": ["polyester-all-purpose", "wooly-nylon"],
"stitches": ["stretch-stitch", "zigzag", "lightning-stitch"]
}
},
"images": ["jersey-knit-closeup.jpg", "jersey-knit-drape.jpg"],
"last_updated": "2026-04-01"
}