Skip to content

Commit 73c879b

Browse files
docs(readme): convert README.adoc -> Markdown README.md (#15)
README must be real Markdown to render in GitHub community-health, the GitHub profile, and external MCP directories (Glama) — AsciiDoc shows as raw markup there. pandoc asciidoc->GFM, badges fixed to clickable, SPDX header kept as an HTML comment, duplicate README.adoc removed. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 817f0eb commit 73c879b

2 files changed

Lines changed: 53 additions & 64 deletions

File tree

README.adoc

Lines changed: 0 additions & 64 deletions
This file was deleted.

README.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
<!--
2+
SPDX-License-Identifier: CC-BY-SA-4.0
3+
SPDX-FileCopyrightText: 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
4+
-->
5+
6+
[![OpenSSF Best Practices](https://img.shields.io/badge/OpenSSF-Best_Practices-green?logo=opensourcesecurity)](https://www.bestpractices.dev/en/projects/new?repo_url=https://github.com/hyperpolymath/humor-ecosystem) <embed
7+
src="https://api.thegreenwebfoundation.org/greencheckimage/github.com"
8+
data-link="https://www.thegreenwebfoundation.org/green-web-check/?url=github.com" />
9+
[![License: MPL-2.0](https://img.shields.io/badge/License-MPL_2.0-blue.svg)](https://opensource.org/licenses/MPL-2.0)
10+
11+
A collection of satirical, parody, and comedic software projects.
12+
Security theater, absurdist tooling, and deliberately bad
13+
implementations — all engineered to a suspiciously high standard.
14+
15+
# Projects
16+
17+
| Project | Description |
18+
|----|----|
19+
| [befunge93-vault-cracker](befunge93-vault-cracker) | Satirical UI demonstrating esoteric programming absurdity vs. overengineered security theater. Uses Befunge-93 to "attack" an imaginary cryptographic vault. |
20+
| [blue-screen-of-app](blue-screen-of-app) | Humorous web app displaying authentic Blue Screen of Death errors across four Windows generations (XP, 7, 10, 11). Built with Deno and ReScript. |
21+
| [dicti0nary-attack](dicti0nary-attack) | Security research parody utility for generating and testing non-dictionary passwords. Demonstrates that creative misspellings are not security. |
22+
| [safe-brute-force](safe-brute-force) | Controlled, ethical brute-force utility with automatic safety pauses every 25 attempts. An OTP gen_statem state machine written in LFE. |
23+
24+
# Purpose
25+
26+
These projects exist to:
27+
28+
- Illustrate security anti-patterns through deliberate absurdity
29+
30+
- Explore esoteric and unusual programming paradigms
31+
32+
- Demonstrate that humor and rigorous engineering are not mutually
33+
exclusive
34+
35+
All projects are fully implemented to Rhodium Standard Repository (RSR)
36+
quality standards despite their comedic subject matter.
37+
38+
# Development
39+
40+
Each sub-project is an independent git submodule with its own build
41+
system, tests, and CI workflows. See the individual project READMEs for
42+
build instructions.
43+
44+
# License
45+
46+
This project is licensed under the Mozilla Public License, v. 2.0. See
47+
the `LICENSE` file for details.
48+
49+
SPDX-License-Identifier: CC-BY-SA-4.0
50+
51+
# Author
52+
53+
Jonathan D.A. Jewell \<[j.d.a.jewell@open.ac](j.d.a.jewell@open.ac).uk\>

0 commit comments

Comments
 (0)