graze logo

snack overflow

by the graze technology teams

Tech blog revamp

Burhan Ali on January 10, 2019

The graze tech blog has been around since the middle of 2013 and has lived on a couple of different platforms in that time. It has moved again and is now hosted on github pages and is powered by Jekyll and Bulma.

Screenshot of blog index page

Why?

Why did we make this move? Well, why not? ¯\_(ツ)_/¯

But actually, there were some more concrete reasons:

  • It was a low impact method of learning about some new technologies that we had not used before.
  • All developers have github accounts and so automatically have the ability to create blog posts. No need to have to maintain an account on another service.
  • It fits in with our existing developer workflow of branch -> PR -> review -> merge.

The most important reason though was that it was fun! This was a nice little project to do towards the end of the year.

How?

There were a number of things that needed doing to get this up and running.

  • Convert the JSON data dump from the previous host into a set of post and author files.
  • Clean up the content (eg. badly encoded characters, non-markdown markup, etc)
  • Add support for a variety of other things:
    • Tags
    • Pagination
    • Post navigation
    • Social media preview metadata
    • Atom feed
  • Set up DNS
  • Run the output through the W3C validator to pick up any markup problems

Everything that has been done is visible in the graze/blog github repo.

The Jekyll documentation is extremely good and was very helpful in this project.

Final thoughts

So what do you think about the new blog? Are there any features that you think are missing? Let us know via github or twitter.