In my daily work, I learn things. In fact, it’s the exception to the rule when I already know how to do what needs to be done. The learning I do is useful in accomplishing the task at hand, but not for much else. It evaporates shortly after I’ve finished. The second time I figure out how to do the same thing will probably be quicker, but I think I can squeeze more value out of the process with minor modifications to my daily routine.

I know from experience, I retain knowledge better when I take notes. The act of writing something down forces my brain to process the information more thoroughly. After documenting a new experience, my recall of that experience improves without even referencing the documentation. So that’s a win right there.

Additionally, if I document the process, that documentation might be useful to me at some point in the future, and it can even be useful to someone else, too.

That’s the motivation behind these bare bones blog posts I’m putting up here. They’re primarily a tool to improve my learning process and secondarily a resource for future me or you.


These are the steps I’ll follow:

Take notes throughout the day

During the course of a day, when I catch myself wondering anything along the lines of, “How do I … ?” I’ll jump to my dedicated notes editor and open a new blog draft titled with whatever question I have. I’ll take notes as I answer the question, asking new questions and documenting helpful resources as appropriate.

Minimally revise notes into blog post

These posts should be functional and minimalist. They should be readable, but just barely.

Publish the post

Get it out into the world.


And these are the tools I’ll use:

Jekyll

Jekyll is a static site generator that lets me create and publish blog posts from my editor and command line.

GitHub Pages

GitHug Pages is the easiest hosting solution for a Jekyll site.

Sublime Text

I love Sublime Text. I switched to VS Code because… I dunno. Peer pressure? It’s a pain keeping two windows of any editor open at the same time, so I’ll use Sublime as a dedicated notes taking editor.

TerminalView

TerminalView will let me create and publish drafts from within Sublime. And this handy plugin I made following this blog will open a Terminal tab every time I launch Sublime

import sublime, sublime_plugin 

def plugin_loaded():
    window = sublime.active_window()
    window.run_command("terminal_view_open", {
      "cmd": "/bin/bash -l -c /bin/zsh",
      "title": "zsh"
    }) 

Now to create and publish a blog, the steps are:

jekyll draft New Blog Title
# Edit _drafts/new-blog-title-md
jekyll publish _drafts/new-blog-title-md
git commit . -m "Publish 'New Blog Title'"
git push