Skip to content

Add diagrams for session structure and REPL dispatch#4032

Merged
bbatsov merged 1 commit into
masterfrom
docs-session-diagrams
Jun 26, 2026
Merged

Add diagrams for session structure and REPL dispatch#4032
bbatsov merged 1 commit into
masterfrom
docs-session-diagrams

Conversation

@bbatsov

@bbatsov bbatsov commented Jun 26, 2026

Copy link
Copy Markdown
Member

Follow-up from the session/connection deep dive. The model behind multi-connection sessions and dispatch is genuinely hard to picture from prose, so this adds two ASCII diagrams to the connection-management guide:

  • In Sessions: how a Sesman session groups a clj and a cljs connection sharing one nREPL server, and that each connection itself carries an eval + a tooling nREPL session.
  • In Current Session: the step-by-step of how an operation in a source buffer resolves to a target REPL (pin -> default session -> Sesman/friendly, optionally pooled by cider-merge-sessions -> type filter -> most-recently-viewed).

ASCII in .... literal blocks - no diagram toolchain to add, renders verbatim on the site, and stays diffable. asciidoctor renders the page clean.

The session/dispatch model is hard to grasp from prose alone.  Add two
ASCII diagrams to the connection-management guide: one showing how a
Sesman session groups a clj and a cljs connection over a shared nREPL
server (with each connection's eval + tooling nREPL sessions), and one
walking through how an operation in a source buffer resolves to a target
REPL (pin -> default session -> Sesman/friendly -> type filter ->
recency).
@bbatsov bbatsov merged commit 503735b into master Jun 26, 2026
13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant