# for-GET/http-decision-diagram

An activity diagram to describe the resolution of HTTP response status codes, given various headers.

Repository: https://github.com/for-GET/http-decision-diagram
Canonical: https://ross.abutalabs.com/products/http-decision-diagram
Homepage: https://github.com/for-GET/http-decision-diagram/blob/master/doc/2013-06-10-http-hell-no.md
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: decision-diagram, http
Last push: 2023-03-19T11:47:05+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4945, "days_push": 1263, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3737, forks 197 (observed 2026-08-28T04:08:15.878382+00:00)

## What it is
An activity diagram (available as PNG/SVG/JSON) that maps how HTTP response status codes are resolved given request headers and caching rules, based on RFC 7230-7235. It also includes companion diagrams for HTTP cache-retrieve and cache-store decisions.

## Use cases
- understand how HTTP status codes are decided from request headers
- learn HTTP caching rules visually
- implement correct HTTP cache-store and cache-retrieve logic
- reference diagram for building an HTTP server or client
- study RFC 7230-7235 status code resolution
- debug why a request returns 304 or 412

## When to choose
- you need a visual, spec-aligned reference for HTTP status code and caching semantics
- you are implementing an HTTP server, proxy, or cache and want a decision flowchart
- you want machine-readable (JSON) state machine data for HTTP decisions

## When to avoid
- you need a runnable HTTP library or framework rather than a diagram
- you need HTTP/2 or HTTP/3 semantics, which the RFC 723x-based diagram does not cover
- you need an actively developed tool with frequent updates

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: documentation, http-server, caching
- domain: web-development, documentation, apis
- platform: cross-platform
- tags: http-status-codes, decision-diagram, rfc7231, http-caching, reference-diagram, rest

## Member repositories
- for-GET/http-decision-diagram (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:15.878382+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:29:09.447143+00:00, confidence not recorded.
  - readme: https://github.com/for-GET/http-decision-diagram (fetched 2026-08-28T04:08:15.878382+00:00, sha cdec3e16321b)
  - homepage: https://github.com/for-GET/http-decision-diagram/blob/master/doc/2013-06-10-http-hell-no.md (fetched 2026-08-29T09:23:55.417105+00:00, sha 83f90544d0f9)
- Data as of 2026-08-30T08:39:29.467469+00:00.