NOTE: This is an update to a previous post.

Okay, it's been a while since the last post on this topic. Since then, I've switched from using the original AsciiDoc utility to Asciidoctor. This along with some minor tweaking has changed how my task lists look.

Here is the basic structure:

= My Task List

[NOTE]
========
.Category Tags
[horizontal]
`code`::
    Code related tasks.
`doc`::
    Documentation related tasks.
========

== Current Tasks
.Updated 2017-01-06
********
NOTE: Arranged by priority.

  - [ ] `2017-01-05 …

Sometimes a directory structure needs a little extra information. Even the most well thought-out directory names lack the expressiveness of a few short remarks. My solution for these cases has been to add a file named __dir_info__.txt to a directory requiring additional details. This file provides an explanation of the directory's purpose, which typically starts with This directory contains ..., and is formatted using AsciiDoc.

Let's look at an example:

= foobar
:date: 5 January 2015 …

This past weekend, I started a side project named Doctrine. It is a desktop application that simplifies viewing the rendered output of an AsciiDoc text file. A quick demo video is shown below:

The motivation behind Doctrine is to streamline the user experience when writing documents in plain text markup. Currently I am only focusing on AsciiDoc but compatibility with other formats (Markdown, ReStructuredText, etc) could be added in the future (integration with Pandoc is …

NOTE: An update to this post is available here.

Task lists are great! Need to do something eventually but don't have the time or motivation to do it now? Add it to a task list (think of it as procrastination management)!

When managing task lists on a computer, I prefer a file-based plain-text approach. As a software developer and avid Vim user, I have found this method to be the most flexible, reliable, and easy …

AsciiDoc is a great markup format for writing notes. In fact, almost all computer-based notes I write are in AsciiDoc; it is simple yet expressive, portable, and most importantly, grepable.

While Vim is my primary tool for viewing AsciiDoc files, looking through the raw text can leave a bit to be desired. Longing for the beautifully rendered output that only an AsciiDoc file can provide, I threw together the following simple (and ugly) Python script …