About this site

As noted on the “Home” page, this web site is hosting a collection of random notes that I’m leaving for myself, which other people may also find useful. These will probably all be technical documents.

Over the past few years I have found myself writing dozens of little Markdown documents, both at work and for my personal projects. I find myself running into two problems with this:

Recently I had asked a question in a Slack channel, and somebody answered it by pointing me to a web page they had written which explained how to do what I was trying to accomplish. The contents of the page probably saved me 2-3 hours at the time, but a few things struck me about it:

I had previously tried to host web pages as Markdown files, and while it sorta worked, something about the process didn’t “feel right” at the time.

So I started looking into Jekyll. I spent some time walking through their Step by Step Tutorial, and then started tweaking things to understand how the pieces all fit together. After a few hours I felt like I understood the basics, and it occurred to me that Jekyll might be a way to finally start moving all of my Markdown docs into a single place, so I registered the “jms1.info” domain and started working on the framework of the site you’re seeing now.


I’ve never really gotten into the whole “blogging” thing, mostly because most of the “blogs” I’ve seen tend to focus on the authors’ personal lives. I tend to be a private person, and I have very little interest in talking about my personal life online, so I always figured “blogging” wasn’t for me.

However, it seems to me that at a technical level, a “blog” is just a collection of documents with certain metadata - dates, authors, tags, and so forth - along with a web interface to make it easy to find and read them. It occurred to me that the only difference between what I’ve always thought of as a “blog”, and a collection of documents, is the nature of the content.

So another part of what I’m doing with this site is seeing if I can coerce a blogging system into acting as a documentation repo.

CC BY-SA 4.0
[hacker emblem]