lune . dev
Numéro N° XXVII
Une revue pour les développeurs

lune

Outils, pensées et artefacts — à la lumière de la lune.

Édition Printemps • MMXXVI • Paris — Kyoto
Faites défiler

A philosophy — for those who craft software the way a horologist sets a balance wheel.

On the quiet practice of making

There is a particular kind of attention required to write a function that lasts. It is the same attention a Parisian binder gives the spine of a folio: not haste, not flourish, but a patient regard for the seam where intention meets execution.

lune.dev exists for the developer who treats the editor as a workshop. Here, you will not find listicles or growth tactics. You will find essays on the act of programming — on naming, on revision, on the unfashionable art of deletion — arranged like chapters in a literary review.

Each issue is set under the sign of a lunar phase. The new moon brings beginnings: an empty file, a blinking cursor, a problem freshly stated. The full moon brings completion: a refactor finished, a release tagged, a small piece of the world made marginally more orderly.

«

Le code, comme la prose, se rature. The page is improved by the line removed.

» — from the editor's foreword

What follows is a long conversation between practitioners. Stay as long as you like. The moon, after all, is in no particular hurry.

A small library of instruments, each shaped to one task and finished by hand.

L'Atelier — instruments of the trade

In the atelier, every tool answers to a discipline. We publish a curated suite of developer utilities, each documented as one might document a clockwork — with diagrams, with care, and with a respect for the user's time.

  1. I.

    Astrolabe

    An observatory for distributed traces. Reads OpenTelemetry spans the way an astronomer reads a star chart — quietly, with annotations in the margin.

  2. II.

    Almanach

    A calendar-aware scheduler. Cron, but written for humans who understand that Tuesday in March is not the same as Tuesday in November.

  3. III.

    Encrier

    A typed inkwell — a tiny, opinionated DSL for sketching API contracts before a single line of server code is written.

  4. IV.

    Phare

    A lighthouse for log streams. Pulses calmly when traffic is well; sweeps a brighter beam when the horizon turns.

Documentation for each instrument is published as a long-form essay in the Codex, never as a quick-start. We believe in reading.

An anthology — long essays, marginalia, and the occasional diagram drawn in ink.

From the Codex — the act of naming

A function's name is its signature in the world; choose it as you would choose the title of a chapter. The reader who comes to your code in three years — and that reader is most often you — will thank you for plain words placed in their proper order.

Below, a fragment from the current issue's lead essay, "Sur la patine du code," in which the author argues that good codebases acquire a soft surface over time, the way a brass instrument does in the hand of a careful player.

Listing I — a small refactor, considered
// avant — the line, as first written
function p(d, f) {
  return d.filter(x => x.t > f);
}

// après — the line, as it wishes to be read
function phasesAfter(phases, threshold) {
  return phases.filter(phase => phase.illumination > threshold);
}

Notice that nothing of substance changed. The machine produces the same result. But the second listing now belongs to a literature: it can be read aloud, it can be quoted, it can be argued with. That is the patine.

Marginalia — the editor reminds the reader that this fragment is set in Crimson Pro, and that the code, set in Fira Code, is the only place in the issue where the serifs yield.

A monthly almanac of releases, lectures, and quiet hours kept by the editorial staff.

Éphémérides — the calendar of the issue

Each cycle of the moon brings its own marginal events. We record them here in the manner of an old almanac — date, lunar phase, and a short notice in the editor's hand.

  • III · iv Astrolabe v0.9 — first stable trace.
  • VII · iv Editorial: « On the unfashionable art of deletion ».
  • XIV · iv Almanach — calendar primitives, documented.
  • XXI · iv Lecture in Le Marais: « Le code et la patine ».
  • XXVIII · iv Issue N° XXVIII goes to press — full moon.

Lectures are held by candlelight in the editor's apartment. Reservations are made by post.

The editor receives letters by lamplight. Subscribe to receive the next issue, by post or by post electronic.

A letter to the editor

Each issue of lune.dev is delivered, in long form, on the morning after the new moon. There is no other cadence. There is no algorithm. There is only the moon, and the post.

La poste lunaire vous répondra à la prochaine nouvelle lune.

Composition

Set in Cormorant & Crimson Pro, with Fira Code for the technical apparatus. Printed in seven shades of moonlight.

Édition

Issue N° XXVII, Spring MMXXVI. Published the morning after the new moon, from a small office in the Marais.

Correspondance

redaction@lune.dev — or, by post, 14 rue de la Lune, 75002 Paris.

Atelier

All instruments are released under permissive license. The essays are released under the discretion of their authors.

☾ lune.dev — MMXXVI ☽