Advanced

Tutor model

i62 💰:9.4

i52 💰:7.9

🏆 i67 💰:62.5

i70 💰:125.0

i68 💰:125.0

🏆 i66 💰:75.0

i65 💰:125.0

i63 💰:62.5

i61 💰:75.0

i60 💰:9.4

i60 💰:37.5

i58 💰:62.5

i57 💰:22.5

i57 💰:37.5

i56 💰:45.0

⚡ i55 💰:11.25

i55 💰:37.5

i54 💰:62.5

i52 💰:35.0

i51 💰:37.5

i49 💰:15.0

i49 💰:62.5

i48 💰:11.3

i47 💰:7.5

i44 💰:25.0

i43 💰:37.5

i42 💰:187.5

i40 💰:5.0

i39 💰:100.0

i38 💰:37.5

i37 💰:11.0

i36 💰:187.5

i34 💰:12.5

i33 💰:37.5

i30 💰:1.0

i29 💰:1.5

i28 💰:150.0

i23 💰:20.0

i20 💰:4.0

i18 💰:1.0

i16 💰:25.0

i13 💰:1.5

Keep session private

What would you like to learn?

Override for the tutor's lesson content generation calls. Auto uses the system default (Claude Sonnet 5 for lesson text, Opus 5 for diagrams).

Lesson generation model

System default

i58 💰:18.8

i31 💰:11.0

i25 💰:31.3

Tutoring abilities

In 1999, NASA lost the $125 million Mars Climate Orbiter because one team logged data in imperial pound-seconds while another team assumed metric newton-seconds without verifying.

In technical fields, poor communication does not just cause confusion — it breaks equipment, wastes millions of dollars, and risks lives.

Every effective technical document relies on three core rules: **clarity**, **conciseness**, and **precision**.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="aspect-ratio" content="4:3">
<title>Principles of Clear Technical Writing</title>
<style>
  * { box-sizing: border-box; margin: 0; padding: 0; }
  body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
    color: #1e2945;
    background: transparent;
    padding: 12px;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    min-height: 100%;
  }

  .nav-bar {
    display: flex;
    gap: 8px;
    width: 100%;
    max-width: 480px;
    margin-bottom: 14px;
  }

  .nav-btn {
    flex: 1;
    padding: 10px 4px;
    font-size: 14px;
    font-weight: 600;
    text-align: center;
    background: #f1f5f9;
    border: 1px solid #e2e8f0;
    border-radius: 8px;
    color: #64748b;
    cursor: pointer;
    transition: all 0.25s ease;
    user-select: none;
  }

  .nav-btn.active {
    background: #22b7ff;
    border-color: #22b7ff;
    color: #ffffff;
    box-shadow: 0 4px 12px rgba(34, 183, 255, 0.25);
  }

  .stage {
    position: relative;
    width: 100%;
    max-width: 480px;
    height: 250px;
    background: #ffffff;
    border: 1px solid #e2e8f0;
    border-radius: 12px;
    overflow: hidden;
  }

  .panel {
    position: absolute;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    display: flex;
    flex-direction: column;
    justify-content: space-around;
    padding: 16px;
    opacity: 0;
    pointer-events: none;
    transition: opacity 0.3s ease;
  }

  .panel.active {
    opacity: 1;
    pointer-events: auto;
  }

  .compare-row {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 12px;
    height: 90px;
  }

  .box {
    flex: 1;
    height: 100%;
    border-radius: 8px;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    padding: 8px;
    text-align: center;
    border: 1px solid transparent;
  }

  .box-before {
    background: #fff1f2;
    border-color: #fecdd3;
    color: #9f1239;
  }

  .box-after {
    background: #f0fdf4;
    border-color: #bbf7d0;
    color: #166534;
  }

  .box-label {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.5px;
    margin-bottom: 4px;
    opacity: 0.8;
  }

  .box-content {
    font-size: 15px;
    font-weight: 600;
  }

  .arrow-sep {
    font-size: 20px;
    color: #94a3b8;
    font-weight: bold;
  }

  .vis-container {
    height: 90px;
    background: #f8fafc;
    border: 1px solid #e2e8f0;
    border-radius: 8px;
    display: flex;
    align-items: center;
    justify-content: center;
    position: relative;
  }

  /* Clarity graphics */
  .maze-line {
    stroke-dasharray: 4;
    animation: dash 12s linear infinite;
  }
  @keyframes dash {
    to { stroke-dashoffset: -100; }
  }

  /* Conciseness graphics */
  .shrink-bars {
    display: flex;
    gap: 8px;
    align-items: center;
  }
  .bar-bloat {
    width: 90px;
    height: 24px;
    background: #fca5a5;
    border-radius: 4px;
    position: relative;
    overflow: hidden;
  }
  .bar-bloat::after {
    content: "";
    position: absolute;
    left: 0;
    top: 50%;
    width: 100%;
    height: 2px;
    background: #e11d48;
  }
  .bar-trim {
    width: 40px;
    height: 24px;
    background: #86efac;
    border-radius: 4px;
  }

  /* Precision graphics */
  .target-grid {
    display: flex;
    align-items: center;
    gap: 24px;
  }
  .meter {
    font-family: monospace;
    font-size: 16px;
    padding: 6px 12px;
    border-radius: 6px;
  }
  .meter-vague {
    background: #fee2e2;
    color: #991b1b;
  }
  .meter-exact {
    background: #dcfce7;
    color: #166534;
    font-weight: bold;
  }

  .controls {
    display: flex;
    gap: 8px;
    margin-top: 12px;
  }

  .dot {
    width: 8px;
    height: 8px;
    border-radius: 50%;
    background: #cbd5e1;
    cursor: pointer;
    transition: background 0.2s ease;
  }

  .dot.active {
    background: #22b7ff;
    transform: scale(1.2);
  }
</style>
</head>
<body>

<div class="nav-bar">
  <button class="nav-btn active" id="btn-0">Clarity</button>
  <button class="nav-btn" id="btn-1">Conciseness</button>
  <button class="nav-btn" id="btn-2">Precision</button>
</div>

<div class="stage">
  
  <div class="panel active" id="panel-0">
    <div class="compare-row">
      <div class="box box-before">
        <span class="box-label">Passive / Murky</span>
        <span class="box-content">Data is sent</span>
      </div>
      <div class="arrow-sep">➔</div>
      <div class="box box-after">
        <span class="box-label">Active / Direct</span>
        <span class="box-content">User sends data</span>
      </div>
    </div>
    <div class="vis-container">
      <svg width="240" height="60" viewBox="0 0 240 60">
        <path d="M 20,45 Q 60,0 80,45 T 140,15" fill="none" stroke="#f87171" stroke-width="2.5" class="maze-line"/>
        <path d="M 140,30 L 220,30" fill="none" stroke="#22c55e" stroke-width="3"/>
        <polygon points="220,25 228,30 220,35" fill="#22c55e"/>
      </svg>
    </div>
  </div>

  
  <div class="panel" id="panel-1">
    <div class="compare-row">
      <div class="box box-before">
        <span class="box-label">Wordy</span>
        <span class="box-content">Due to the fact</span>
      </div>
      <div class="arrow-sep">➔</div>
      <div class="box box-after">
        <span class="box-label">Trimmed</span>
        <span class="box-content">Because</span>
      </div>
    </div>
    <div class="vis-container">
      <div class="shrink-bars">
        <div class="bar-bloat"></div>
        <div class="arrow-sep" style="font-size:16px;">➔</div>
        <div class="bar-trim"></div>
      </div>
    </div>
  </div>

  
  <div class="panel" id="panel-2">
    <div class="compare-row">
      <div class="box box-before">
        <span class="box-label">Vague</span>
        <span class="box-content">Wait a while</span>
      </div>
      <div class="arrow-sep">➔</div>
      <div class="box box-after">
        <span class="box-label">Exact</span>
        <span class="box-content">Wait 5.0 s</span>
      </div>
    </div>
    <div class="vis-container">
      <div class="target-grid">
        <div class="meter meter-vague">~ ? sec</div>
        <div class="arrow-sep" style="font-size:16px;">➔</div>
        <div class="meter meter-exact">5.00 s</div>
      </div>
    </div>
  </div>
</div>

<div class="controls">
  <div class="dot active" id="dot-0"></div>
  <div class="dot" id="dot-1"></div>
  <div class="dot" id="dot-2"></div>
</div>

<script src="{{VENDOR_CDN}}/classace-diagram.js"></script>
<script>
  const panels = [$('#panel-0'), $('#panel-1'), $('#panel-2')];
  const btns = [$('#btn-0'), $('#btn-1'), $('#btn-2')];
  const dots = [$('#dot-0'), $('#dot-1'), $('#dot-2')];
  let current = 0;
  let timer = null;

  function show(idx) {
    current = idx;
    panels.forEach((p, i) => p.classList.toggle('active', i === idx));
    btns.forEach((b, i) => b.classList.toggle('active', i === idx));
    dots.forEach((d, i) => d.classList.toggle('active', i === idx));
  }

  function next() {
    show((current + 1) % 3);
  }

  function startAuto() {
    stopAuto();
    timer = setInterval(next, 3500);
  }

  function stopAuto() {
    if (timer) clearInterval(timer);
  }

  btns.forEach((b, i) => {
    onTap(b, () => {
      show(i);
      startAuto();
    });
  });

  dots.forEach((d, i) => {
    onTap(d, () => {
      show(i);
      startAuto();
    });
  });

  startAuto();
</script>
</body>
</html>

How do you make complex technical procedures instantly understandable on the first read?

**Clarity** means your reader understands your exact message instantly without having to re-read sentences.

The fastest way to achieve clarity is using **active voice** with a direct **Subject-Verb-Object** order, placing the person or agent doing the action right at the start.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="aspect-ratio" content="4:3">
<style>
  * { box-sizing: border-box; margin: 0; padding: 0; }
  body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
    color: #1e2945;
    background: transparent;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    min-height: 100%;
    padding: 12px;
    gap: 12px;
  }

  .nav-tabs {
    display: flex;
    background: #eef2f6;
    padding: 4px;
    border-radius: 24px;
    gap: 4px;
  }

  .tab-btn {
    border: none;
    background: transparent;
    padding: 6px 16px;
    font-size: 14px;
    font-weight: 600;
    color: #64748b;
    border-radius: 20px;
    cursor: pointer;
    transition: all 0.25s ease;
  }

  .tab-btn.active {
    background: #ffffff;
    color: #0284c7;
    box-shadow: 0 2px 6px rgba(0,0,0,0.08);
  }

  .card-container {
    width: 100%;
    max-width: 480px;
    display: flex;
    flex-direction: column;
    gap: 12px;
  }

  .flow-card {
    background: #ffffff;
    border: 2px solid #e2e8f0;
    border-radius: 12px;
    padding: 16px 12px;
    display: flex;
    flex-direction: column;
    gap: 10px;
    transition: all 0.3s ease;
  }

  .flow-card.highlight {
    border-color: #0284c7;
    box-shadow: 0 4px 12px rgba(2, 132, 199, 0.12);
  }

  .flow-header {
    display: flex;
    justify-content: space-between;
    align-items: center;
    font-size: 14px;
    font-weight: 700;
  }

  .tag {
    font-size: 12px;
    padding: 3px 8px;
    border-radius: 6px;
    font-weight: 600;
  }

  .tag-direct {
    background: #dcfce7;
    color: #15803d;
  }

  .tag-indirect {
    background: #f1f5f9;
    color: #64748b;
  }

  .nodes-row {
    display: grid;
    grid-template-columns: 1fr auto 1fr auto 1fr;
    align-items: center;
    gap: 6px;
  }

  .node {
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    padding: 8px 4px;
    border-radius: 8px;
    text-align: center;
  }

  .node-role {
    font-size: 11px;
    text-transform: uppercase;
    letter-spacing: 0.5px;
    font-weight: 700;
    margin-bottom: 2px;
  }

  .node-word {
    font-size: 14px;
    font-weight: 600;
  }

  .node-subject {
    background: #e0f2fe;
    color: #0369a1;
  }

  .node-verb {
    background: #fef3c7;
    color: #b45309;
  }

  .node-object {
    background: #f1f5f9;
    color: #475569;
  }

  .flow-arrow {
    font-size: 16px;
    font-weight: bold;
    color: #94a3b8;
    text-align: center;
  }

  .flow-card.highlight .flow-arrow {
    color: #0284c7;
  }

  .active-pulse {
    animation: flowPulse 2s infinite ease-in-out;
  }

  @keyframes flowPulse {
    0%, 100% { transform: scale(1); opacity: 0.9; }
    50% { transform: scale(1.03); opacity: 1; }
  }
</style>
</head>
<body>

  <div class="nav-tabs">
    <button class="tab-btn active" onclick="setMode('active')">Active</button>
    <button class="tab-btn" onclick="setMode('passive')">Passive</button>
    <button class="tab-btn" onclick="setMode('both')">Compare</button>
  </div>

  <div class="card-container">
    
    <div id="card-active" class="flow-card highlight active-pulse">
      <div class="flow-header">
        <span style="color: #0284c7;">Active Voice (S–V–O)</span>
        <span class="tag tag-direct">✓ Direct</span>
      </div>
      <div class="nodes-row">
        <div class="node node-subject">
          <span class="node-role">Subject</span>
          <span class="node-word">Technician</span>
        </div>
        <span class="flow-arrow">→</span>
        <div class="node node-verb">
          <span class="node-role">Verb</span>
          <span class="node-word">inspects</span>
        </div>
        <span class="flow-arrow">→</span>
        <div class="node node-object">
          <span class="node-role">Object</span>
          <span class="node-word">valve</span>
        </div>
      </div>
    </div>

    
    <div id="card-passive" class="flow-card">
      <div class="flow-header">
        <span style="color: #64748b;">Passive Voice</span>
        <span class="tag tag-indirect">Indirect</span>
      </div>
      <div class="nodes-row">
        <div class="node node-object">
          <span class="node-role">Object</span>
          <span class="node-word">Valve</span>
        </div>
        <span class="flow-arrow">←</span>
        <div class="node node-verb">
          <span class="node-role">Verb</span>
          <span class="node-word">is inspected</span>
        </div>
        <span class="flow-arrow">←</span>
        <div class="node node-subject">
          <span class="node-role">Agent</span>
          <span class="node-word">by tech</span>
        </div>
      </div>
    </div>
  </div>

  <script>
    function setMode(mode) {
      const btns = document.querySelectorAll('.tab-btn');
      const cActive = document.getElementById('card-active');
      const cPassive = document.getElementById('card-passive');

      btns[0].classList.toggle('active', mode === 'active');
      btns[1].classList.toggle('active', mode === 'passive');
      btns[2].classList.toggle('active', mode === 'both');

      if (mode === 'active') {
        cActive.style.display = 'flex';
        cPassive.style.display = 'none';
        cActive.classList.add('highlight', 'active-pulse');
        cPassive.classList.remove('highlight', 'active-pulse');
      } else if (mode === 'passive') {
        cActive.style.display = 'none';
        cPassive.style.display = 'flex';
        cPassive.classList.add('highlight');
        cActive.classList.remove('highlight', 'active-pulse');
      } else {
        cActive.style.display = 'flex';
        cPassive.style.display = 'flex';
        cActive.classList.add('highlight');
        cPassive.classList.remove('highlight');
        cActive.classList.remove('active-pulse');
      }
    }
  </script>
</body>
</html>

When writing instructions or safety alerts, use the **imperative mood** — direct commands that begin with a strong action verb like *connect*, *measure*, or *inspect*.

What happens when clear sentences become buried under piles of unnecessary words?

**Conciseness** is delivering all necessary technical information in the fewest words possible without sacrificing meaning.

Watch out for **nominalizations** — verbs disguised as clunky nouns, such as writing *conduct an investigation of* instead of simply writing *investigate*.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta name="aspect-ratio" content="4:3">
  <title>Nominalization Transformation</title>
  <script src="https://cdn.jsdelivr.net/npm/classace-diagram@1.0.0/dist/index.min.js"></script>
  <style>
    * {
      box-sizing: border-box;
      margin: 0;
      padding: 0;
    }

    body {
      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
      background: transparent;
      color: #1e2945;
      display: flex;
      flex-direction: column;
      align-items: center;
      justify-content: center;
      min-height: 100%;
      padding: 16px 8px;
    }

    .main-wrap {
      width: 100%;
      max-width: 500px;
      display: flex;
      flex-direction: column;
      gap: 16px;
      align-items: center;
    }

    /* Tab switcher */
    .tabs {
      display: flex;
      gap: 8px;
      background: #f1f5f9;
      padding: 4px;
      border-radius: 20px;
      border: 1px solid #e2e8f0;
    }

    .tab-btn {
      border: none;
      background: transparent;
      padding: 6px 14px;
      border-radius: 16px;
      font-size: 14px;
      font-weight: 600;
      color: #6b7280;
      cursor: pointer;
      transition: all 0.25s ease;
    }

    .tab-btn.active {
      background: #ffffff;
      color: #22b7ff;
      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.06);
    }

    /* Stage display */
    .stage {
      width: 100%;
      background: #f8f9fa;
      border: 1px solid #e6e6e6;
      border-radius: 12px;
      padding: 24px 16px;
      display: flex;
      flex-direction: column;
      align-items: center;
      gap: 16px;
      position: relative;
    }

    /* Row item */
    .phrase-row {
      display: flex;
      flex-wrap: wrap;
      justify-content: center;
      align-items: center;
      gap: 6px;
      min-height: 44px;
    }

    .token {
      display: inline-flex;
      align-items: center;
      justify-content: center;
      padding: 8px 12px;
      border-radius: 8px;
      font-size: 15px;
      font-weight: 600;
      transition: all 0.35s ease;
      position: relative;
    }

    /* Clunky state */
    .token-clunky {
      background: #fee2e2;
      color: #b91c1c;
      border: 1px solid #fca5a5;
    }

    .token-clunky.struck {
      opacity: 0.45;
      text-decoration: line-through;
      text-decoration-color: #ef4444;
      text-decoration-thickness: 2px;
    }

    /* Arrow transition */
    .arrow {
      font-size: 20px;
      color: #94a3b8;
      line-height: 1;
    }

    /* Crisp direct verb */
    .token-crisp {
      background: #d1fae5;
      color: #065f46;
      border: 1px solid #6ee7b7;
      font-size: 17px;
      padding: 10px 18px;
      box-shadow: 0 2px 8px rgba(16, 185, 129, 0.15);
    }

    /* Visual Efficiency Meter */
    .meter-box {
      width: 100%;
      max-width: 320px;
      display: flex;
      align-items: center;
      gap: 12px;
      padding-top: 4px;
    }

    .bar-track {
      flex: 1;
      height: 8px;
      background: #e2e8f0;
      border-radius: 4px;
      overflow: hidden;
      display: flex;
    }

    .bar-fill {
      height: 100%;
      transition: width 0.4s ease, background-color 0.4s ease;
      border-radius: 4px;
    }

    .bar-fill.long {
      background: #ef4444;
    }

    .bar-fill.short {
      background: #10b981;
    }

    .stat-badge {
      font-size: 13px;
      font-weight: 700;
      color: #10b981;
      min-width: 48px;
      text-align: right;
    }

    /* Dot indicators */
    .dots {
      display: flex;
      gap: 6px;
      margin-top: -4px;
    }

    .dot {
      width: 8px;
      height: 8px;
      border-radius: 50%;
      background: #cbd5e1;
      cursor: pointer;
      transition: background 0.2s ease;
    }

    .dot.active {
      background: #22b7ff;
    }
  </style>
</head>
<body>
  <div class="main-wrap">
    
    <div class="tabs" role="tablist">
      <button class="tab-btn active" id="tab0">1</button>
      <button class="tab-btn" id="tab1">2</button>
      <button class="tab-btn" id="tab2">3</button>
    </div>

    
    <div class="stage">
      
      <div class="phrase-row" id="clunkyGroup"></div>

      
      <div class="arrow">↓</div>

      
      <div class="phrase-row">
        <span class="token token-crisp" id="crispToken"></span>
      </div>

      
      <div class="meter-box">
        <div class="bar-track">
          <div class="bar-fill short" id="meterBar" style="width: 25%;"></div>
        </div>
        <div class="stat-badge" id="statBadge">−75%</div>
      </div>
    </div>

    
    <div class="dots">
      <div class="dot active" id="dot0"></div>
      <div class="dot" id="dot1"></div>
      <div class="dot" id="dot2"></div>
    </div>
  </div>

  <script>
    const data = [
      {
        clunky: ["conduct", "an", "investigation", "of"],
        crisp: "investigate",
        reduction: "−75%",
        percent: 25
      },
      {
        clunky: ["make", "a", "decision"],
        crisp: "decide",
        reduction: "−67%",
        percent: 33
      },
      {
        clunky: ["perform", "an", "analysis", "of"],
        crisp: "analyze",
        reduction: "−75%",
        percent: 25
      }
    ];

    let currentIndex = 0;
    let timer = null;

    function render(index) {
      currentIndex = index;
      const item = data[index];

      // Update tabs & dots
      for (let i = 0; i < 3; i++) {
        const tab = document.getElementById('tab' + i);
        const dot = document.getElementById('dot' + i);
        if (i === index) {
          tab.classList.add('active');
          dot.classList.add('active');
        } else {
          tab.classList.remove('active');
          dot.classList.remove('active');
        }
      }

      // Render tokens
      const clunkyGroup = document.getElementById('clunkyGroup');
      clunkyGroup.innerHTML = '';
      item.clunky.forEach((word) => {
        const span = document.createElement('span');
        span.className = 'token token-clunky struck';
        span.textContent = word;
        clunkyGroup.appendChild(span);
      });

      // Crisp token
      const crispToken = document.getElementById('crispToken');
      crispToken.textContent = item.crisp;

      // Meter bar
      const meterBar = document.getElementById('meterBar');
      meterBar.style.width = item.percent + '%';

      const statBadge = document.getElementById('statBadge');
      statBadge.textContent = item.reduction;
    }

    function goTo(index) {
      render(index);
      resetAutoPlay();
    }

    function resetAutoPlay() {
      clearInterval(timer);
      timer = setInterval(() => {
        const next = (currentIndex + 1) % data.length;
        render(next);
      }, 3500);
    }

    // Attach listeners
    for (let i = 0; i < 3; i++) {
      const tab = document.getElementById('tab' + i);
      const dot = document.getElementById('dot' + i);
      tab.addEventListener('click', () => goTo(i));
      dot.addEventListener('click', () => goTo(i));
    }

    // Initial run
    render(0);
    resetAutoPlay();
  </script>
</body>
</html>

Cutting filler words like *due to the fact that* down to *because* saves reading time and prevents errors during high-stress operations.

Even if a sentence is clear and short, what happens if your instructions leave room for guessing?

**Precision** requires replacing fuzzy qualifiers with exact, measurable values and standardized units.

Words like *hot*, *fast*, *soon*, or *a small amount* are subjective — what seems *warm* to one technician might cause a chemical explosion for another.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="aspect-ratio" content="4:3">
<title>Technical Precision & Units</title>
<style>
  * { box-sizing: border-box; margin: 0; padding: 0; }
  body {
    font-family: system-ui, -apple-system, sans-serif;
    color: #1e2945;
    background: transparent;
    padding: 12px;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: space-between;
    min-height: 100%;
    gap: 12px;
  }

  .nav-tabs {
    display: flex;
    gap: 8px;
    width: 100%;
    max-width: 440px;
  }

  .tab-btn {
    flex: 1;
    padding: 8px 12px;
    border: 2px solid #e6e6e6;
    background: #ffffff;
    color: #6b7280;
    font-size: 14px;
    font-weight: 600;
    border-radius: 8px;
    cursor: pointer;
    text-align: center;
    transition: background 0.2s, border-color 0.2s, color 0.2s;
  }

  .tab-btn.active {
    border-color: #22b7ff;
    background: #f0f9ff;
    color: #0284c7;
  }

  .flow-grid {
    display: grid;
    grid-template-columns: 1fr auto 1fr;
    align-items: center;
    gap: 8px;
    width: 100%;
    max-width: 440px;
  }

  .spec-box {
    background: #ffffff;
    border: 1px solid #e6e6e6;
    border-radius: 8px;
    padding: 8px;
    text-align: center;
  }

  .spec-title {
    font-size: 12px;
    font-weight: 600;
    color: #6b7280;
    margin-bottom: 4px;
  }

  .spec-val {
    font-family: monospace;
    font-size: 14px;
    font-weight: 700;
  }

  .arrow {
    font-size: 18px;
    color: #9ca3af;
  }

  .sim-area {
    width: 100%;
    max-width: 440px;
    background: #ffffff;
    border: 1px solid #e6e6e6;
    border-radius: 12px;
    position: relative;
    overflow: hidden;
  }

  svg {
    display: block;
    width: 100%;
    height: auto;
  }

  .status-badge {
    position: absolute;
    bottom: 8px;
    right: 8px;
    font-family: monospace;
    font-size: 13px;
    font-weight: 700;
    padding: 4px 8px;
    border-radius: 6px;
  }

  .status-err {
    background: #fee2e2;
    color: #b91c1c;
    border: 1px solid #fca5a5;
  }

  .status-ok {
    background: #dcfce7;
    color: #15803d;
    border: 1px solid #86efac;
  }

  .path-line {
    transition: stroke-dashoffset 1s ease, stroke 0.3s ease;
  }
</style>
</head>
<body>

  <div class="nav-tabs">
    <button id="btn-err" class="tab-btn active" onclick="setMode('err')">⚠️ Missing Units</button>
    <button id="btn-ok" class="tab-btn" onclick="setMode('ok')">✓ Explicit Units</button>
  </div>

  <div class="flow-grid">
    <div class="spec-box">
      <div class="spec-title">Team A (Input)</div>
      <div id="val-a" class="spec-val">4.45 lbf</div>
    </div>
    <div class="arrow">→</div>
    <div class="spec-box">
      <div class="spec-title">Team B (Readout)</div>
      <div id="val-b" class="spec-val" style="color:#dc2626;">4.45 N ✗</div>
    </div>
  </div>

  <div class="sim-area">
    <svg viewBox="0 0 400 170" fill="none">
      
      <circle cx="330" cy="85" r="45" fill="#f97316" />
      <circle cx="330" cy="85" r="52" stroke="#fdba74" stroke-width="1.5" stroke-dasharray="3 3" />
      <text x="330" y="90" text-anchor="middle" fill="#ffffff" font-size="14" font-weight="700">Mars</text>

      
      <path d="M 20 85 C 150 85, 230 40, 330 40" stroke="#e5e7eb" stroke-width="2" stroke-dasharray="4 4" />

      
      <path id="traj" d="M 20 85 C 150 85, 250 85, 305 85" stroke="#dc2626" stroke-width="3" fill="none" />

      
      <g id="craft" transform="translate(290, 75)">
        <text font-size="20">🛰️</text>
      </g>
    </svg>
    <div id="badge" class="status-badge status-err">Lost (57 km) ✗</div>
  </div>

<script>
  function setMode(mode) {
    const btnErr = document.getElementById('btn-err');
    const btnOk = document.getElementById('btn-ok');
    const valA = document.getElementById('val-a');
    const valB = document.getElementById('val-b');
    const traj = document.getElementById('traj');
    const craft = document.getElementById('craft');
    const badge = document.getElementById('badge');

    if (mode === 'err') {
      btnErr.className = 'tab-btn active';
      btnOk.className = 'tab-btn';
      valA.innerHTML = '4.45 <span style="color:#6b7280;font-size:11px;">(lbf)</span>';
      valB.innerHTML = '4.45 <span style="color:#dc2626;">N ✗</span>';
      valB.style.color = '#dc2626';

      traj.setAttribute('d', 'M 20 85 C 150 85, 240 85, 300 85');
      traj.setAttribute('stroke', '#dc2626');
      craft.setAttribute('transform', 'translate(285, 75)');

      badge.className = 'status-badge status-err';
      badge.textContent = 'Lost (57 km) ✗';
    } else {
      btnErr.className = 'tab-btn';
      btnOk.className = 'tab-btn active';
      valA.innerHTML = '4.45 N';
      valB.innerHTML = '4.45 N ✓';
      valB.style.color = '#16a34a';

      traj.setAttribute('d', 'M 20 85 C 150 85, 230 40, 330 40');
      traj.setAttribute('stroke', '#16a34a');
      craft.setAttribute('transform', 'translate(318, 28)');

      badge.className = 'status-badge status-ok';
      badge.textContent = 'Orbit (226 km) ✓';
    }
  }

  // Initial state
  setMode('err');
</script>
</body>
</html>

A common mistake beginners make is confusing technical writing with creative writing, believing that complex vocabulary makes an author sound more intelligent.

In technical fields, fancy jargon obscures your meaning — the best technical writers choose plain language so any authorized operator can execute the task safely.

How do all three principles work together when repairing real-world technical documentation?

Let us examine a poorly written maintenance entry from an IT server repair log.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta name="aspect-ratio" content="4:3">
  <style>
    * {
      box-sizing: border-box;
      margin: 0;
      padding: 0;
    }
    body {
      font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
      background: transparent;
      color: #1e2945;
      padding: 12px;
      display: flex;
      flex-direction: column;
      align-items: center;
      gap: 12px;
      user-select: none;
    }

    /* Controls */
    .controls {
      display: flex;
      gap: 8px;
      width: 100%;
      max-width: 420px;
    }
    .toggle-btn {
      flex: 1;
      padding: 8px 12px;
      border-radius: 8px;
      border: 1px solid #d1d5db;
      background: #ffffff;
      font-size: 14px;
      font-weight: 600;
      cursor: pointer;
      display: flex;
      align-items: center;
      justify-content: center;
      gap: 6px;
      transition: background 0.2s, border-color 0.2s, color 0.2s, box-shadow 0.2s;
    }
    .toggle-btn.active-ambiguous {
      background: #fef3c7;
      border-color: #f59e0b;
      color: #92400e;
      box-shadow: 0 0 0 2px rgba(245, 158, 11, 0.2);
    }
    .toggle-btn.active-precise {
      background: #ecfeff;
      border-color: #06b6d4;
      color: #0e7490;
      box-shadow: 0 0 0 2px rgba(6, 182, 212, 0.2);
    }

    /* Diagram Stage */
    .stage {
      width: 100%;
      max-width: 440px;
      display: flex;
      flex-direction: column;
      gap: 10px;
    }

    /* Spec Block */
    .spec-card {
      padding: 10px;
      border-radius: 8px;
      font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
      font-size: 15px;
      font-weight: 700;
      text-align: center;
      transition: background 0.3s, border-color 0.3s, color 0.3s;
    }
    .spec-card.ambiguous {
      background: #fffbeb;
      border: 1.5px dashed #f59e0b;
      color: #b45309;
    }
    .spec-card.precise {
      background: #f0fdf4;
      border: 1.5px solid #10b981;
      color: #047857;
    }

    /* Flow split */
    .flow-grid {
      display: grid;
      grid-template-columns: 1fr 1fr;
      gap: 8px;
    }
    .team-box {
      padding: 8px;
      border-radius: 6px;
      background: #f8fafc;
      border: 1px solid #e2e8f0;
      text-align: center;
      font-size: 13px;
      font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
    }
    .team-box .label {
      font-family: system-ui, sans-serif;
      font-size: 11px;
      color: #64748b;
      font-weight: 600;
      margin-bottom: 2px;
    }
    .team-box .val {
      font-weight: 700;
    }
    .val.warn {
      color: #d97706;
    }
    .val.match {
      color: #059669;
    }

    /* Visual Simulation */
    .visual-sim {
      width: 100%;
      height: 160px;
      background: #0f172a;
      border-radius: 8px;
      position: relative;
      overflow: hidden;
    }
    svg {
      width: 100%;
      height: 100%;
    }

    /* Trajectory animation */
    .orbit-path {
      fill: none;
      stroke-width: 2.5;
      stroke-dasharray: 400;
      stroke-dashoffset: 400;
      animation: drawPath 2.5s ease-out infinite;
    }
    .path-ambiguous {
      stroke: #ef4444;
    }
    .path-precise {
      stroke: #10b981;
    }

    @keyframes drawPath {
      0% {
        stroke-dashoffset: 400;
        opacity: 1;
      }
      80% {
        stroke-dashoffset: 0;
        opacity: 1;
      }
      100% {
        stroke-dashoffset: 0;
        opacity: 0.2;
      }
    }

    .status-tag {
      position: absolute;
      bottom: 8px;
      right: 8px;
      padding: 3px 8px;
      border-radius: 4px;
      font-size: 12px;
      font-weight: 700;
    }
    .status-ambiguous {
      background: #7f1d1d;
      color: #fecaca;
      border: 1px solid #ef4444;
    }
    .status-precise {
      background: #064e3b;
      color: #a7f3d0;
      border: 1px solid #10b981;
    }
  </style>
</head>
<body>

  <div class="controls">
    <button id="btnAmbiguous" class="toggle-btn active-ambiguous" onclick="setMode(false)">
      <span>⚠</span> Ambiguous
    </button>
    <button id="btnPrecise" class="toggle-btn" onclick="setMode(true)">
      <span>✓</span> Precise
    </button>
  </div>

  <div class="stage">
    
    <div id="specCard" class="spec-card ambiguous">
      thrust = 4.45
    </div>

    
    <div class="flow-grid">
      <div class="team-box">
        <div class="label">Team A</div>
        <div id="teamAVal" class="val warn">4.45 lbf·s</div>
      </div>
      <div class="team-box">
        <div class="label">Team B</div>
        <div id="teamBVal" class="val warn">4.45 N·s</div>
      </div>
    </div>

    
    <div class="visual-sim">
      <svg viewBox="0 0 320 160">
        
        <circle cx="240" cy="80" r="32" fill="#c2410c" />
        <circle cx="240" cy="80" r="38" fill="none" stroke="#ea580c" stroke-width="1.5" stroke-dasharray="3 3" opacity="0.6" />

        
        <ellipse id="targetOrbit" cx="240" cy="80" rx="55" ry="50" fill="none" stroke="#059669" stroke-width="1" stroke-dasharray="2 3" opacity="0.4" style="display:none;" />

        
        <path id="trajectory" class="orbit-path path-ambiguous" d="M 20 25 Q 160 30 230 75" />

        
        <circle cx="20" cy="25" r="4" fill="#38bdf8" />
      </svg>
      <div id="statusTag" class="status-tag status-ambiguous">Mismatch ✕</div>
    </div>
  </div>

  <script>
    function setMode(isPrecise) {
      const btnAmbiguous = document.getElementById('btnAmbiguous');
      const btnPrecise = document.getElementById('btnPrecise');
      const specCard = document.getElementById('specCard');
      const teamA = document.getElementById('teamAVal');
      const teamB = document.getElementById('teamBVal');
      const trajectory = document.getElementById('trajectory');
      const targetOrbit = document.getElementById('targetOrbit');
      const statusTag = document.getElementById('statusTag');

      if (isPrecise) {
        btnPrecise.className = 'toggle-btn active-precise';
        btnAmbiguous.className = 'toggle-btn';

        specCard.className = 'spec-card precise';
        specCard.textContent = 'thrust = 4.45 N·s';

        teamA.textContent = '4.45 N·s';
        teamA.className = 'val match';
        teamB.textContent = '4.45 N·s';
        teamB.className = 'val match';

        targetOrbit.style.display = 'block';
        trajectory.setAttribute('class', 'orbit-path path-precise');
        trajectory.setAttribute('d', 'M 20 25 Q 160 25 240 30 A 55 50 0 1 1 239.9 30');

        statusTag.textContent = 'Aligned ✓';
        statusTag.className = 'status-tag status-precise';
      } else {
        btnAmbiguous.className = 'toggle-btn active-ambiguous';
        btnPrecise.className = 'toggle-btn';

        specCard.className = 'spec-card ambiguous';
        specCard.textContent = 'thrust = 4.45';

        teamA.textContent = '4.45 lbf·s';
        teamA.className = 'val warn';
        teamB.textContent = '4.45 N·s';
        teamB.className = 'val warn';

        targetOrbit.style.display = 'none';
        trajectory.setAttribute('class', 'orbit-path path-ambiguous');
        trajectory.setAttribute('d', 'M 20 25 Q 160 30 230 75');

        statusTag.textContent = 'Mismatch ✕';
        statusTag.className = 'status-tag status-ambiguous';
      }

      // Restart trajectory animation smoothly
      trajectory.style.animation = 'none';
      trajectory.offsetHeight; /* trigger reflow */
      trajectory.style.animation = null;
    }
  </script>
</body>
</html>

The revised version cuts passive fluff, names the specific technician and rack, and replaces vague words with exact temperatures and fan speeds.

Before you submit your next technical report or lab log, read each sentence and ask: Is the actor clear, have I cut every useless word, and can someone measure my results?

career

Principles of Clear Technical Writing. Apply core principles of clarity, conciseness, and precision when writing technical documents.

Language: Revising for Concision and Clarity

Grade 9 Language Arts: Use Words Accurately and Precisely

Communicating with Precision and the 7 Cs of Professional Writing

Teaching 9th-grade technical communication under TEKS 127.15 requires shifting students from 'expressive' or 'creative' prose to 'functional' prose. Effective instruction uses before-and-after sentence surgery labs, guided redaction activities (calculating a 'reduction percentage' without losing critical data), and rubric-based peer reviews evaluating clarity, conciseness, and quantitative precision.

Principles of Clear Technical Writing

Principle 1: Clarity

Principle 2: Conciseness