quality.pug

---
layout: default
title: Quality Signals
description: Browse blog posts and wiki articles by maturity, confidence, and quality
permalink: /quality/
hero: true
---

.hero
  div
    h1 {{ page.title }}
    p.excerpt {{ page.description }}

main.container.mx-auto.px-4.py-8
  .max-w-5xl.mx-auto
    .prose.mx-auto.mb-10
      p.text-lg
        | These fields are lightweight editorial signals, not hard guarantees.
        |  They help readers distinguish rough sketches from finished references,
        |  hands-on notes from factual summaries, and stronger pieces from weaker ones.
      p
        | The taxonomy is still evolving. Older entries mix evidence-style confidence
        |  labels like #[code experience] and #[code fact] with simpler confidence
        |  levels like #[code high] and #[code medium]. This page reflects the current
        |  corpus honestly instead of pretending it is cleaner than it is.

    div(class="grid gap-4 md:grid-cols-3 mb-10")
      article.p-5.rounded-xl.border(class="bg-surface/40 border-primary/15")
        h2.text-lg.font-bold.mb-2.text-primary Maturity
        p.text-sm.m-0(class="text-text/70")
          | How developed the piece is: from seed ideas to finished references.
      article.p-5.rounded-xl.border(class="bg-surface/40 border-border/70")
        h2.text-lg.font-bold.mb-2 Confidence
        p.text-sm.m-0(class="text-text/70")
          | How strongly I stand behind it, or what kind of evidence it rests on.
      article.p-5.rounded-xl.border(class="bg-surface/40 border-amber-500/20")
        h2.text-lg.font-bold.mb-2(class="text-amber-700") Quality
        p.text-sm.m-0(class="text-text/70")
          | A rough editorial score. Higher is better, but it is still subjective.

    section.mb-14
      .flex.items-baseline.gap-3.mb-4.pb-2.border-b.border-border
        h2.text-2xl.font-bold.m-0.text-primary Maturity
        span.text-sm(class="text-text/40") Browse by stage of development

      .flex.flex-wrap.gap-2.mb-6
        | {% assign maturity_values = "seed,seedling,draft,in-progress,published,finished" | split: "," %}
        | {% for value in maturity_values %}
        |   {% assign value_count = 0 %}
        |   {% for post in site.posts %}{% if post.maturity == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% for article in site.knowledge %}{% if article.maturity == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% if value_count > 0 %}
        a.inline-flex.items-center.gap-1.no-underline.rounded-lg.transition-colors(
          href="#maturity-{{ value | slugify }}"
          class="px-3 py-1.5 bg-surface border border-border hover:border-primary hover:text-primary text-text/70 text-sm"
        )
          | {{ value }}
          span.text-xs(class="text-text/40") {{ value_count }}
        |   {% endif %}
        | {% endfor %}

      | {% for value in maturity_values %}
      |   {% assign value_count = 0 %}
      |   {% for post in site.posts %}{% if post.maturity == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% for article in site.knowledge %}{% if article.maturity == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% if value_count > 0 %}
      section.mb-8(id="maturity-{{ value | slugify }}")
        .flex.items-baseline.gap-3.mb-3
          h3.text-xl.font-bold.m-0 {{ value }}
          span.text-sm(class="text-text/40") {{ value_count }} item{% if value_count != 1 %}s{% endif %}

        | {% if value == "seed" %}
        p.text-sm.mb-3(class="text-text/60") Early idea or sketch. Useful for direction, not polish.
        | {% elsif value == "seedling" %}
        p.text-sm.mb-3(class="text-text/60") More developed than a seed, but still exploratory.
        | {% elsif value == "draft" %}
        p.text-sm.mb-3(class="text-text/60") A real draft. The structure exists, but details may still move.
        | {% elsif value == "in-progress" %}
        p.text-sm.mb-3(class="text-text/60") Actively being refined as the work evolves.
        | {% elsif value == "published" %}
        p.text-sm.mb-3(class="text-text/60") Public and stable enough to reference, even if not fully settled.
        | {% elsif value == "finished" %}
        p.text-sm.mb-3(class="text-text/60") Mature reference material or a write-up I consider complete.
        | {% endif %}

        | {% for post in site.posts %}
        |   {% if post.maturity == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          time.text-xs.whitespace-nowrap.flex-shrink-0.w-16(class="text-text/40") {{ post.date | date: "%b %Y" }}
          div
            a.text-base.font-semibold.no-underline(href="{{ post.url }}" class="text-text hover:text-primary transition-colors") {{ post.title }}
            | {% assign excerpt_stripped = post.excerpt | strip_html | strip | truncatewords: 12 %}
            | {% assign title_stripped = post.title | strip %}
            | {% unless excerpt_stripped == "" or excerpt_stripped == title_stripped %}
            span.text-sm.ml-2(class="text-text/50") — {{ excerpt_stripped }}
            | {% endunless %}
        |   {% endif %}
        | {% endfor %}

        | {% for article in site.knowledge %}
        |   {% if article.maturity == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          span.text-xs.font-medium.uppercase.tracking-wider.flex-shrink-0.w-16(class="text-text/30") wiki
          div
            a.text-base.font-semibold.no-underline(href="{{ article.url }}" class="text-text hover:text-primary transition-colors") {{ article.title }}
            | {% if article.description %}
            span.text-sm.ml-2(class="text-text/50") — {{ article.description | strip_html | truncatewords: 12 }}
            | {% endif %}
        |   {% endif %}
        | {% endfor %}
      |   {% endif %}
      | {% endfor %}

    section.mb-14
      .flex.items-baseline.gap-3.mb-4.pb-2.border-b.border-border
        h2.text-2xl.font-bold.m-0.text-primary Confidence
        span.text-sm(class="text-text/40") Browse by confidence or evidence style

      .flex.flex-wrap.gap-2.mb-6
        | {% assign confidence_values = "speculation,medium,high,experience,fact" | split: "," %}
        | {% for value in confidence_values %}
        |   {% assign value_count = 0 %}
        |   {% for post in site.posts %}{% if post.confidence == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% for article in site.knowledge %}{% if article.confidence == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% if value_count > 0 %}
        a.inline-flex.items-center.gap-1.no-underline.rounded-lg.transition-colors(
          href="#confidence-{{ value | slugify }}"
          class="px-3 py-1.5 bg-surface border border-border hover:border-primary hover:text-primary text-text/70 text-sm"
        )
          | {{ value }}
          span.text-xs(class="text-text/40") {{ value_count }}
        |   {% endif %}
        | {% endfor %}

      | {% for value in confidence_values %}
      |   {% assign value_count = 0 %}
      |   {% for post in site.posts %}{% if post.confidence == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% for article in site.knowledge %}{% if article.confidence == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% if value_count > 0 %}
      section.mb-8(id="confidence-{{ value | slugify }}")
        .flex.items-baseline.gap-3.mb-3
          h3.text-xl.font-bold.m-0 {{ value }}
          span.text-sm(class="text-text/40") {{ value_count }} item{% if value_count != 1 %}s{% endif %}

        | {% if value == "speculation" %}
        p.text-sm.mb-3(class="text-text/60") Informed guesswork or open-ended reasoning. Read it as hypothesis, not settled truth.
        | {% elsif value == "medium" %}
        p.text-sm.mb-3(class="text-text/60") Moderately trusted, but still carrying visible uncertainty.
        | {% elsif value == "high" %}
        p.text-sm.mb-3(class="text-text/60") Strong confidence in the claim or conclusion.
        | {% elsif value == "experience" %}
        p.text-sm.mb-3(class="text-text/60") Grounded mainly in hands-on experience rather than external citation.
        | {% elsif value == "fact" %}
        p.text-sm.mb-3(class="text-text/60") Meant as a factual summary or evidence-backed statement.
        | {% endif %}

        | {% for post in site.posts %}
        |   {% if post.confidence == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          time.text-xs.whitespace-nowrap.flex-shrink-0.w-16(class="text-text/40") {{ post.date | date: "%b %Y" }}
          div
            a.text-base.font-semibold.no-underline(href="{{ post.url }}" class="text-text hover:text-primary transition-colors") {{ post.title }}
            | {% assign excerpt_stripped = post.excerpt | strip_html | strip | truncatewords: 12 %}
            | {% assign title_stripped = post.title | strip %}
            | {% unless excerpt_stripped == "" or excerpt_stripped == title_stripped %}
            span.text-sm.ml-2(class="text-text/50") — {{ excerpt_stripped }}
            | {% endunless %}
        |   {% endif %}
        | {% endfor %}

        | {% for article in site.knowledge %}
        |   {% if article.confidence == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          span.text-xs.font-medium.uppercase.tracking-wider.flex-shrink-0.w-16(class="text-text/30") wiki
          div
            a.text-base.font-semibold.no-underline(href="{{ article.url }}" class="text-text hover:text-primary transition-colors") {{ article.title }}
            | {% if article.description %}
            span.text-sm.ml-2(class="text-text/50") — {{ article.description | strip_html | truncatewords: 12 }}
            | {% endif %}
        |   {% endif %}
        | {% endfor %}
      |   {% endif %}
      | {% endfor %}

    section.mb-14
      .flex.items-baseline.gap-3.mb-4.pb-2.border-b.border-border
        h2.text-2xl.font-bold.m-0(class="text-amber-700") Quality
        span.text-sm(class="text-text/40") Browse by editorial score

      .flex.flex-wrap.gap-2.mb-6
        | {% assign quality_values = "9,8,7,6,good" | split: "," %}
        | {% for value in quality_values %}
        |   {% assign value_count = 0 %}
        |   {% for post in site.posts %}{% assign post_quality = post.quality | append: "" %}{% if post_quality == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% for article in site.knowledge %}{% assign article_quality = article.quality | append: "" %}{% if article_quality == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
        |   {% if value_count > 0 %}
        a.inline-flex.items-center.gap-1.no-underline.rounded-lg.transition-colors(
          href="#quality-{{ value | slugify }}"
          class="px-3 py-1.5 bg-surface border border-border hover:border-amber-500 hover:text-amber-700 text-text/70 text-sm"
        )
          | {% if value == "good" %}{{ value }}{% else %}{{ value }}/10{% endif %}
          span.text-xs(class="text-text/40") {{ value_count }}
        |   {% endif %}
        | {% endfor %}

      | {% for value in quality_values %}
      |   {% assign value_count = 0 %}
      |   {% for post in site.posts %}{% assign post_quality = post.quality | append: "" %}{% if post_quality == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% for article in site.knowledge %}{% assign article_quality = article.quality | append: "" %}{% if article_quality == value %}{% assign value_count = value_count | plus: 1 %}{% endif %}{% endfor %}
      |   {% if value_count > 0 %}
      section.mb-8(id="quality-{{ value | slugify }}")
        .flex.items-baseline.gap-3.mb-3
          h3.text-xl.font-bold.m-0
            | {% if value == "good" %}{{ value }}{% else %}{{ value }}/10{% endif %}
          span.text-sm(class="text-text/40") {{ value_count }} item{% if value_count != 1 %}s{% endif %}

        | {% if value == "9" %}
        p.text-sm.mb-3(class="text-text/60") Strong enough that I would point people at it without much hesitation.
        | {% elsif value == "8" %}
        p.text-sm.mb-3(class="text-text/60") Solid work. Worth reading and probably reusable.
        | {% elsif value == "7" %}
        p.text-sm.mb-3(class="text-text/60") Good and useful, even if not exceptional.
        | {% elsif value == "6" %}
        p.text-sm.mb-3(class="text-text/60") Decent, but less polished or less important than the stronger pieces.
        | {% elsif value == "good" %}
        p.text-sm.mb-3(class="text-text/60") Legacy non-numeric label retained for older entries.
        | {% endif %}

        | {% for post in site.posts %}
        |   {% assign post_quality = post.quality | append: "" %}
        |   {% if post_quality == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          time.text-xs.whitespace-nowrap.flex-shrink-0.w-16(class="text-text/40") {{ post.date | date: "%b %Y" }}
          div
            a.text-base.font-semibold.no-underline(href="{{ post.url }}" class="text-text hover:text-primary transition-colors") {{ post.title }}
            | {% assign excerpt_stripped = post.excerpt | strip_html | strip | truncatewords: 12 %}
            | {% assign title_stripped = post.title | strip %}
            | {% unless excerpt_stripped == "" or excerpt_stripped == title_stripped %}
            span.text-sm.ml-2(class="text-text/50") — {{ excerpt_stripped }}
            | {% endunless %}
        |   {% endif %}
        | {% endfor %}

        | {% for article in site.knowledge %}
        |   {% assign article_quality = article.quality | append: "" %}
        |   {% if article_quality == value %}
        article.flex.items-baseline.gap-4.py-2(class="hover:bg-surface/30 -mx-3 px-3 rounded transition-colors")
          span.text-xs.font-medium.uppercase.tracking-wider.flex-shrink-0.w-16(class="text-text/30") wiki
          div
            a.text-base.font-semibold.no-underline(href="{{ article.url }}" class="text-text hover:text-primary transition-colors") {{ article.title }}
            | {% if article.description %}
            span.text-sm.ml-2(class="text-text/50") — {{ article.description | strip_html | truncatewords: 12 }}
            | {% endif %}
        |   {% endif %}
        | {% endfor %}
      |   {% endif %}
      | {% endfor %}