Superficie – Surface Syntax for Clojure to Help Exposition/Onboarding
Superficie is a bidirectional renderer for Clojure that translates S-expressions into a more readable syntax. It aims to facilitate communication between Clojure developers and those familiar with other languages like Python and TypeScript. The tool allows users to write Clojure code normally and render it into a more accessible format for presentations and discussions.
- ▪Superficie translates Clojure S-expressions into a syntax that is easier for non-Clojure developers to read.
- ▪It is designed to help in presentations, documentation, and conversations with domain experts.
- ▪Superficie does not create a separate ecosystem and allows for round-tripping between its syntax and Clojure.
Opening excerpt (first ~120 words) tap to expand
Superficie Surface syntax for Clojure — a bidirectional renderer that translates Clojure S-expressions into familiar, readable syntax and back. Why? During my PhD in machine learning, I worked in Clojure while everyone around me used Python. I couldn't show my code to colleagues, supervisors, or domain experts without first explaining parentheses. In presentations, papers, and code reviews, the syntax was a wall — not because S-expressions are bad, but because you can't expect someone to parse them on the fly when they've never seen them before. That initial unfamiliarity typically takes a few days to overcome. But a few days is infinity when you're in a meeting, reading a blog post, or reviewing code with someone outside your team. Superficie exists to remove that barrier.
…
Excerpt limited to ~120 words for fair-use compliance. The full article is at GitHub.