About

Civitas Icon

Clojure Civitas makes it easy for you to publish Clojure ideas and explorations without the overhead of setting up a new project, blog, or repo. Whether you’re sketching out a quick experiment or writing a deeper post, just create a namespace, write, commit and submit. This is your shared scratch space.

Non-linear exploration

Navigate your own path through interconnected topics.

Literate by design

Write notebooks and situate them in a broader context by linking ideas.

Community supported growth

The best resources rise through collective refinement.

An open effort to structure learning resources with meaningful connections.

“Civitas” refers to a community of citizens, encompassing the rights, duties, and privileges associated with belonging. It’s a term that signifies citizenship, not just a physical city, but also the political and social fabric of the community.

Usage

See README.md.

Rationale

Clojure and markdown are a natural fit for interactive, literate programming. But there is incidental complexity in setup and publishing. Creating a new project, configuring a blog, choosing themes and styling, organizing files, adding analytics, and thinking about SEO all add overhead. This friction discourages experimentation and makes publishing harder than it needs to be.

Make Publishing Clojure Namespaces Easy

Markdown comments in Clojure namespaces is a perfect fit for interactive literate programming. Creators should only have to care about their code, not setting up projects or hosting workflows. Let’s make a shared, organized platform for short experiments, tutorials, notes, and blog posts.

Build a Database of Knowledge

Civitas aggregates structured metadata about the content it hosts and links it to other Clojure resources. We can build a connected web of ideas, showing how concepts relate, what builds on what, and where to go next. A hex-grid interface presents these relationships visually. Each notebook can declare prerequisites, alternatives, and follow-ups. This helps learners discover next steps, helps educators design coherent learning paths, and enables the community to improve content over time. The goal is to make the Clojure knowledge ecosystem easier to explore and navigate.

Embrace Alternatives

Clojure Civitas does not aim to centralize Clojure knowledge. Rather it hopes to amplify existing resources, connect with them, and add a place in between for raw ideas and creative experiments.

Honey bees beehive

How it Works

Minimal Moderation and Curation

Content is submitted via Pull Requests, which are reviewed to prevent abuse. A small team of reviewers ensures quick turnaround. Community representatives are available to assist and guide contributors.

Metadata Creation

Metadata is provided by authors. Future improvements may include automated extraction and smarter linking to enrich the knowledge base.

Analytics

Page view analytics are publicly available. See the Clojure Civitas Analytics Dashboard.

Technical Details

Made with Clay. See the README.md in the repository for contribution guidelines and technical details.

Why markdown in code?

We value reproducible artifacts. Start with code. Make it work. Then tell the story.