docs: preserve upstream English README

2026-07-13 10:23:30 +00:00
parent 6a2f6934bb
commit ffc75977d2
1 changed files with 41 additions and 0 deletions
@@ -0,0 +1,41 @@
+# The unreasonable effectiveness of HTML — examples
+
+> **Sample code. Not maintained and not accepting contributions.**
+
+A gallery of standalone HTML examples that accompany the blog post on using HTML
+as a flexible output format. Each file is a self-contained `.html` page (no build
+step, no dependencies) demonstrating a different use case — from code review and
+design systems to slide decks, status reports, and small interactive editors.
+
+Open [`index.html`](index.html) for the full, categorized index, or open any
+numbered file directly in a browser.
+
+## Contents
+
+| Category | Examples |
+|---|---|
+| Exploration | code approaches, visual designs |
+| Code | review, understanding, design systems, component variants |
+| Prototyping | animation, interaction |
+| Communication | slide deck, status report, incident report, PR write-up |
+| Diagrams & research | flowchart, feature/concept explainers |
+| Custom editing UIs | triage board, feature flags, prompt tuner |
+
+## Running
+
+There is nothing to install or build. Clone the repo and open `index.html` (or
+any individual file) in a web browser.
+
+## A note on sample data
+
+All product names, data, and scenarios in these examples are fictional and used
+only for illustration. The placeholder brand "Acme" and any figures shown are
+not real.
+
+## Security
+
+See [SECURITY.md](SECURITY.md) for how to report a vulnerability.
+
+## License
+
+Released under the [Apache License 2.0](LICENSE).