Golem Doc
Michael Bernstein zopemaven@gmail.com
The Origin & Philosophy
In traditional Jewish lore, a golem (גולם) is formed from unshaped clay or earth and brought to life through the animating power of the inscribed word—an embodiment of truth (אמת) dedicated to labor and purpose.
Golem draws upon that textual tradition: the conviction that words carry structural, animating force.
Temperamentally, Golem is an unadorned, heavy-duty tool: solid, capable, and completely unpretentious. It brings a craftsman's respect for enduring materials to technical documentation—engineered for longevity, transparent operation, and a refusal to indulge in fragile, ephemeral tooling.
The Publishing Workbench
Golem was created to serve as an unadorned, heavy-duty publishing workbench for Python developers, data scientists, and technical authors.
Modern documentation tooling has increasingly inherited the fragility and churn of the JavaScript frontend ecosystem. Golem takes an intentional step back to first principles:
- Python-Native: The compiler, dev server, doctest runners, and plugin hooks are standard, idiomatic Python.
- AsciiDoc Native: Deep support for book-grade technical writing—39 node types, native inclusion trees, mathematical formulas, admonitions, and callouts—without the indentation landmines of reStructuredText or the semantic poverty of Markdown.
- Pure HTML/CSS Foundation: Zero JavaScript required for standard page layout, responsive collapsing, and automatic light/dark mode adaptation.
- Respect for the Fellow Craftsman: Clean AST/ASG resolution, pluggy lifecycle hooks, and compiler-grade error coordinates (
path:line:col) for every issue.
Project Documents & Governance
Explore the official project documents, specifications, and governance:
- The Colophon — Publication details, typography, color palette tokens, and build environment.
- Changelog — Chronological release history and semver changes.
- Security Policy — Vulnerability disclosure protocols and supported versions.
- Code of Conduct — Community standards and craftsman pledge.
- Software License — Apache License, Version 2.0.