Skip to content
Marc Schmitt edited this page May 4, 2025 · 4 revisions

Explanations

This section contains understanding-oriented theory and concepts to help build deeper knowledge of the tools, materials, and processes at Seattle Makers. Unlike tutorials or how-to guides that focus on completing tasks, explanations provide theoretical foundations and context.

Available Explanations by Department

3D Printing {#3D-Printing}

CNC {#CNC}

Electronics {#Electronics}

Laser Cutting {#Laser-Cutting}

Metalworking {#Metalworking}

Screen Printing {#Screen-Printing}

Sewing {#Sewing}

Woodworking {#Woodworking}

How to write explanations

From Diataxis:

Explanation is a discursive treatment of a subject, that permits reflection. Explanation is understanding-oriented.

Explanation deepens and broadens the reader's understanding of a subject. It brings clarity, light and context. Explanation - understanding oriented, theoretical knowledge, that serves our study

The concept of reflection is important. Reflection occurs after something else, and depends on something else, yet at the same time brings something new - shines a new light - on the subject matter.

The perspective of explanation is higher and wider than that of the other not types. It does not take the user's eye-level view, as in a how-to guide, or a close-up view of the machinery, like reference material.

When writing explanations for this wiki:

  • Focus on building understanding, not completing tasks
  • Include background information and context
  • Explain the "why" behind processes and principles
  • Use diagrams and illustrations where helpful
  • Connect concepts across different areas of making when relevant
  • Consider including history or theoretical foundations

Clone this wiki locally