Introducing documentation on bayton.org

Originally published at: https://bayton.org/2017/05/introducing-documentation-on-bayton-org/

The way content is published on bayton.org is changing. Despite efforts to incorporate features into posts based on length, complexity, etc, I’ve not been pleased with the results. As such, over the last few weekends I’ve been working on a new area of the site dedicated to long-form, technical articles which will benefit from features like: Hierarchical navigation While categories and tags have their place, when reading through documentation on a subject there’s nothing quite as good as having content-aware navigation, allowing quick access to both similar topics, those in a series, or just having the ability to jump up a level without requiring any additional effort. Contents Every article will now have a table of contents to refer to, saving endless scrolling on longer articles as is currently the case. Linked headings To make it as easy possible to: Share the article from a particular point Pick up exactly where you left off via a simple link Each heading now has it’s own direct link within a document: Organisation by colour and highlighting recently published To make it easier to differentiate between topics, each one has a unique colour; super useful for finding related documentation at a glance: Furthermore, all new documentation is highlighted beneath the topic it sits under, as demonstrated above. Regular updates Traditional WordPress posts tend to drift off into the abyss after they’re pushed out of the first page in the admin area and it’s very much a case of out of sight, out of mind unless a…