# Site refresh

> We're giving the site its annual service.

Programming notice, 29th July: we're giving the site its annual service.

## Content

The content here evolves over time. This idea isn't static: as the world changes, so do our ideas. Some of the stuff we've produced recently clashes with the advice on this site, which isn't ideal.

I consider the main pages of the site to be like the Johnny.Decimal user manual. So when we change them, we do it with great consideration. Which takes time. I don't like to just jump in and make edits.

Fortunately I have an actual editor sitting next to me: Lucy. She's going to review all of our content, and we'll do an update to make sure everything is consistent with our current thinking.

This will take a few weeks, but it'll be worth it. So please bear with us.

## Style

You may also notice that some of the styling is a little wonky. This is because I am a very poor web developer. I need to separate some things out so that when I tweak one thing _over there_ it doesn't have unintended consequences _over here_.

This will happen at the same time as the content update. Don't worry, no big changes. Just a spit 'n polish.

## Control

I'll start to track these changes more rigorously. So I've added a [version number](/01.04/) to the site, directly under the list of pages.

I consider this the 5th major version (since 2013) so I've labelled it `5.0.0`.

[01.04 Version](/01.04/) will contain a summary of every change.

Using [Semantic Versioning](https://semver.org), the numbers will increment as follows.

- Third digit: 'PATCH' change.

  - `5.0.0` → `5.0.1`
  - Fixing a **typo** or otherwise a **minor tweak** that doesn't fundamentally affect the structure of the system.
  - Any update to the **style** of the site that doesn't change the **content**.
  - You don't need to care about these changes.

- Second digit: 'MINOR' change.

  - `5.0.0` → `5.1.0`
  - A **new page** on the main site, i.e. _not including blog posts_.
  - Significant changes to content on **a single/few page(s)**.
  - You should familiarise yourself with this change.

- First digit: 'MAJOR' change.
  - `5.0.0` → `6.0.0`
  - Significant changes to content on **many pages**.
  - You should familiarise yourself with this change.

## Stay informed

Subscribe to [The Quarterly](/21.02/) for exactly 4 updates a year. Or point your RSS reader at the site. All pages are included in the feed.