Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Writing history posts

How to write "this month in Exponential history" and other history posts from the project's own chronicle and ledger - choose a month or theme, cite commits, explain what became possible, use the old name correctly…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/advocates/writing-history-posts.md

On this page

Writing history posts

This page is for advocates who like stories. Exponential has an unusually complete, public history: every change since December 2023 is told month by month in the chronicle and recorded in the ledger, and the repository history goes back to 2002. History posts show that the project is alive and explain why features exist.

Contents

  1. The sources
  2. Post ideas
  3. How to write one
  4. The template
  5. Rules for history

The sources

SourceWhat it gives you
The history"The story of every change ... since the se7enxweb era began in December 2023", month by month
The ledgerThe complete record of commits per repository
The ecosystemChanges across the related repositories
Who is 7x?, Nearly thirty yearsThe long timeline
Who is 7x?, The eZ Publish yearsThe years before 2021
TimelineKey dates with sources
git log in a cloneEvery commit since 2002

Each month page opens with In short and ends with related pages; every change carries its commit hash, which readers can open with git show <hash> (The history, In short).

Post ideas

IdeaStart from
"This month two years ago"The month page of two years ago
"How SQLite came to Exponential"January 2024
"The month the product got its name"August 2025
"From PHP 7 to PHP 8.5"April 2025, December 2025
"The story of Velocity"Velocity chronicle
"A year of releases"Who is 7x?, The 6.0.x releases
"The first outside contribution"December 2023

How to write one

  1. Read the month page fully, then the commits you will mention (git show <hash>).
  2. Pick three changes that a reader can still use today.
  3. For each: what changed, why it mattered, what you can do now. Link the feature page.
  4. Add one sentence of context: what else happened in the project then.
  5. End with a link to the month page so readers can read the rest.

The template

# This month in Exponential history: <Month Year>

<One sentence: what the month brought, from the "In short" of the month page.>

## <Change 1>
<What changed and why it mattered.> You can still use it: <feature page>. Commit: `<hash>`.

## <Change 2>
...

## Read more
The full month: <link to the month page>. Every change of that time is in the ledger: <link>.

<Disclosure line.>

Rules for history

  • Use the chronicle's facts, not your memory of the time.
  • The old name in the past tense only: "while the software was still called eZ Publish" (Writing about the history correctly).
  • Credit people only as the sources do. Contributors named in the history and on Who is 7x? may be named as there; do not add private details.
  • No speculation about why someone did something, unless a source says it.
  • Respect earlier companies. eZ Systems' work is part of the code; speak of it with respect (Respecting other projects and companies).

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x