-
An example of onboarding process & documentation for remote developers joining a specialised team
Onboarding engineers to a project is hard. Especially if you’re in a small team (e.g. Android developers) without a whole HR framework, and instead have to make up your own processes! I’ve onboarded tens of engineers (and been onboarded of course), so here’s a few mistakes I’ve learned from, and my current preferred approach for onboarding new engineers.
-
Introducing "diet.co.ke", a silly mini-project
This weekend I discovered Kenya sells “co.ke” domains. Obviously the only thing to do was register “diet.co.ke”, and put up a fun little landing page!
-
How to fix an incorrectly HTTP canonical URL / resource when serving Jekyll over GitHub Pages with HTTPS
Recently I was looking at this site on Google Search Console, and noticed a few warnings about HTTP canonical URLs. This was a little confusing, since all my content is HTTPS, and it was only happening on one site. Turns out the problem was a GitHub Pages setting I’d forgotten to change…
-
Setting up a tidy 3-monitor, 2-laptop standing desk workspace
Exactly 2 years ago, I wrote about my revamped WFH setup. Now I’ve moved… everything has changed again! Here’s everything wrong with my old setup, and how I built the new one. As before, this is partially to remember my own reasoning, and partially to provide ideas for anyone with similar needs.
-
Using SimpleJekyllSearch for easy and quick site searching
Historically, my Jekyll sites have always had a very slow search feature. Recently I updated minimaJake to use SimpleJekyllSearch, and now it’s almost instant (99.5% reduction in time taken) and easy to customise! Here’s some more detail on how it works, how to implement it, and some further improvements I’d love to try.
-
Introducing 'minimaJake', a minima theme fork for Jekyll with years of improvements & design changes!
Over the last few years I’ve slowly added functionality to the default Jekyll “minima” theme, and recently made it all publicly available. Here’s a description of & integration details for all the new features minimaJake offers, from comments to Ko-fi support to accent colouring!
-
How I merged my 3 Jekyll site codebases into 1, as a public theme
Up until last week I had 3 blogs, each with their own GitHub repositories, copies of code, CSS modifications, and overall configuration. Whilst this worked, it was impossible to maintain or scale up. In this post I’ll describe how I merged all of these into 1, whilst also updating to the latest Minima version and making future improvements much easier to implement.
-
How to add a new social media link to Minima 2.5.1 and latest unreleased version (3.0.0)
Recently I migrated all of my Jekyll sites from Minima 2.5.1 (updated August 2019) to the latest version on GitHub (updated January 2023). This came with lots of new features, but also changed how social links are handled. In this post I’ll cover both the old and new method for adding new social links, as well as the technical details.
-
An introduction to GitHub & Jekyll's footnote functionality, and finding its limits
Way back in September 2021, GitHub added support for footnotes, an intuitive way to add footnotes or references to a page. The “Kramdown” parser on Jekyll has also supported footnotes for a decade. But… what are they actually capable of?
-
How to display complex content (lists, code, images) inside a table reliably in Markdown / GitHub / Jekyll
As anyone who writes in Markdown knows, it’s a very concise and easy way to write almost all content. However, tables can be a little bit awkward, especially if it includes multi-line content like a list! Here’s a quick comparison of techniques that can be used to solve this, and whether they work in plain Markdown, GitHub, and Jekyll blogs.