I just wanted to install a github-flavored markdown plugin for vim. Until today I only used vim as it falls out of the box. So I had to do a couple detours before I got a vim plugin installed. Since I like the simplicity of the Mikado Method I apply it very often (maybe too often). In this case I used a very simple form of it, actually mainly to document all the steps I had to take on this detour. Read more below.

tmux's fault

personal kanban via tmux
personal kanban using tmux and vim

A little bit of background story: It all started last night, after another round of discussing an apprenticeship program at HolidayCheck. And since I learned at 8th Light that tmux and vim are the two essential tools every apprentice learns, I fianlly wanted to sit down and learn those tools too.
I tweeted that I had found a great tutorial to install tmux (see related-tweets in the side bar). So I went along and actually got started pretty fast on using tmux. I went to bed happily, I had learned all I needed to get started with tmux in less than one hour.
And in the morning I had the glorious idea to switch to tmux and vim for maintaining my private kanban board. I wanted to have three panes, the backlog, in progress and done column and in each I have a file open, which I edit using vim. This way I can learn tmux and vim, both at the same time.
Actually I had started using vi, not vim. But I switched to vim, when I found no vi plugins, but only vim plugins. And another bit later I found out that vi is no more than a symlink to vim, at least on my machine :).

Vim Plugin and Mikado Method?

Having my three columns prepared I only needed a github-flavored markdown editor for some syntax highlighting. And the github style enables the nice checkbox style (- [ ] ...) that I use even in any regular markdown files. And to highlight those properly, I needed the right plugin for vim.
After a while I figured out, this is a rabbit whole for a vim beginner like me.

Every time I start making two or more extra steps before reaching the actual goal right away (here installing the vim plugin which highlights github-flavored markdown properly) I think of the Mikado Method. It's for one perfect for documenting all things and also for structuring and not forgetting the essential things when climbing back out of the rabbit hole. Actually it can be applied in many more (complex) contexts as described in the linked article, but I found it also helps structuring in getting things done and not forgetting what I actually wanted to do.

A couple of dependent steps were necessary to install the vim plugin. And in order to not loose focus and not forget a step that would come next but gets overruled by a sub-step of the current one I use the Mikado Method.

Install vim-plugin

Here are the steps I had to do to explore how to get this vim plugin installed on a "fresh" vim.

  • ❓I want a github-flavored markdown syntax highlighter for vim
  • 👍 try it out, open the file via vim some.md (especially one with github-style check boxes - [ ] ... and ... I can see it highlighted ... yeah
  • 👍 DONE, "pure joy"

Finally

It's true, the Mikado Method explained in the article is way more sophisticated. But doing those tedious things like learning to install a vim plugin always reminds me of the Mikado Method. And since I usually write down my "Mikado steps" using nested lists, like in here, this is the simplest form of using the Mikado Method.
Have fun trying it, it can really safe ones sanity and keep you focused.