Skip to content

Latest commit

 

History

History
27 lines (19 loc) · 1.37 KB

mistakes.md

File metadata and controls

27 lines (19 loc) · 1.37 KB
permalink layout title
/making/mistakes/
default
~ Making Mistakes

Making Mistakes

A list of mistakes I’ve made maintaining this site and the reasoning behind making the changes to rectify them.

Moving Pages

One problem with the evolution of a blog is the temptation to change it. One thing I’ve tried to commit to from the start is a single url design but recently I’ve changed my mind and broken a few things. The reasons vary; scaling the site’s content, changes in build tool version and functionality, better url design UX and good ol’ indecisiveness.

A general lack of publish date url design

Jekyll offers date url design out of the box. Posts are built into a directory structure yy/mm/dd enabling a more date hackable url design. Compare this of my current writing design writing/ground-zero/ vs writing/2013/02/16/ground-zero, the latter purveying date relevance form the url. There is also the issue of repeated entry titles e.g. writing/ground-zero/ written in 2016. Moving to the afforementioned design would also enable me to archive less relevant content as and when it’s needed.

Lessons learned

  • URL design precedes the initial commit
  • Map out the design with real content
  • Experiment with the language
  • Be consistent
  • If it feels boated or clunky, you’ve probably made a mistake
  • Abstract it
  • Think future friendly