Where should I keep notes?

I’ve been banging my head against a problem for a while and it is wearing me out, so I am gonna kick it out to you fine folks for advice.

My problem is that I want to keep notes in a searchable (digital) format, but I can’t figure out where or how. I’ve considered keeping notes here in WordPress, running MediaWiki or DokuWiki, just a bunch text files in git, a git-backed wiki, a wiki attached to a git repo, in one of a dozen Markdown enabled quasi-wikae, and so forth.

My past was my future

I learn by doing, and I remember through repetition. I have difficulty listening to what others say, so I take notes. I can hardly transcribe someone spelling a word or a phone number, because I just can’t keep all the immediate information in mind.

In the past I’ve been embarrassed about that, but I know there are both learning methods at work as well as my personal trauma that lends itself to my inability to listen to a person dumping information. I don’t judge myself so hard because I am an attentive listener to people sharing and emoting with me, and in an emergency I keep a cool head and can process information very quickly. It is that last fact that causes me trouble; I idle in emergency mode, hence my need to take notes when there isn’t danger.

Another thing about me that makes note-taking so valuable is that I attended 22 educational institutions before being kicked out of high school and passing the California High School Proficiency Exam. Between leaving school and taking the exam I worked in the IT department of a city government. In other words, despite the years of self-doubt and fear that I was a fool, I survived by becoming an autodidact early in life, and was more than prepared for the wellspring of knowledge that accompanied the ubiquity of the open web starting in the late 90s.

In other words, I learn by taking notes, and find inspiration in sharing with others.

Buckets and scaffolding

Recently I’ve taken the craft of note-taking and self-learning to new personal highs, and that means plunging into what I refer to as brain stuff. Everywhere I look there are explanations for why humans act as they do (that includes me), and it is a great body of knowledge that isn’t fitting into my existing framework of collecting information in deep buckets, and then mixing it across broad subjects or themes. And then of course repeating this over and over as I get more information, building the scaffolding of my knowledge until it becomes applicable.

Practically that means I am filling up notebooks and storing them, not fully processing the contents, and therefore capturing but not digesting. And it is wearing me down.

So I am looking for something, some system, that can relieve the pressure of my mind, a release valve to dump information somewhere I know I can find it later and move it around and draw conclusions and build into new self-discoveries, etc.


This isn’t the first time I’ve been thinking in wiki, and a lot of what I thought then still applies, except I don’t think the age of my tools (WordPress for example) are holding them back; indeed free software that is useful, and therefore used, seems to adjust and grow in the ways it needs to survive.

And if I am allowed a moment of romantic thinking, that method of survival appeals to me. ^_^

But that doesn’t solve my problem. Where should I keep my notes?

Words words words

Here are some things I would like, for sure:

  • Easy to write, which probably means Markdown for me, because I hardly use any formatting except for the very simple rules that are in all Markdown flavors (rarely headings, unordered lists a lot, and links are slightly easier than a hrefs).
  • Easy tagging, because I want to create ad-hoc collections of knowledge unintentionally
  • Easy referencing: double square brackets in wikicode is one of the most addictive properties I’ve ever encountered on the open web, it is my personal Xanadu.
  • Easy to search (not a huge problem, since my notes are just a complex index for my brain)

There is another category with one item in it, and I will call this “the thing I don’t understand about myself”: I want it to be publicly available. I am straddling a fence with this, because I don’t know what drives me to make everything that I produce public and open. I sometimes wonder if I deny myself a safe and private space to make mistakes and test assumptions without it being captured and used against me, but I feel I get enough of that from my family and friends, and that I can’t self-correct without the input and visibility gained from sharing publicly. Even if I decide on text files in a local folder, it will be synced somewhere public.

Okay, so those are my desires and a big question. Now consider the systems and tools I know.


Let’s start with the obvious, since this dance I have with MediaWiki is constant. A lot of the issues I have with MediaWiki, such as user accounts and spam won’t be a problem for my single user requirement.

There is so much going for MediaWiki.

  • Easy referencing, with reporting tools that assist in deepening buckets of knowledge (show me most referred to non-existent pages from a given category, please!)
  • Robust taxonomies and semantic tools for structuring data in personally meaningful ways, but still easy to tweak as needed
  • Decent search with additional options
  • PHP app, easy to use with my most familiar software stacks
  • Transclusion. Makes templating amazingly straightforward, and cross-referencing can be wondrous.

But there is still a lot about MediaWiki I can’t stand.

  • Installation really sucks for anything besides a vanilla install, dependency gets weird for something like the semantic modules.
  • URLs make me so irritated. MediaWiki is the only software I’ve come across that don’t form lowercase, dashed words in URLs. My name doesn’t start with M, and it visually distracts me when I view an article on a MediaWiki site. Workarounds break some linking functionality.
  • Themes in MediaWiki suck. There is a design aesthetic to wikae dictated by Wikipedia, and we might just be stuck with it. Alternatives ask that content be changed in such a way that one can’t easily switch between skins, and that is even worst.
  • MediaWiki markup is way more complicated than Markdown to do normal things, and alternatives require additional server resources I don’t want to give. So Parsoid is out for me.
  • Portability is an issue. I can’t copy and paste into a blog post, which is how it should work.
  • It seems kinda overkill to run such a robust framework for a single person to take notes.


Now here is a fun little project that hits a lot of my points.

  • New(ish) Markdown plugin that doesn’t require special tags to use.
  • Content is just text files with some extras around it.
  • URLs are sane, a direct comparison to MediaWiki.
  • Can do fun things with git, some potential for hacking there.
  • Very little hosting requirements.

Not many things I dislike.

  • Themes are kinda ugly, would need to fix that.
  • Searching is somewhat limited, and not many options to change, but could be a non-point with a decent taxonomy.
  • Taxonomies aren’t as easy to use.

Gollum (or any git-based file system)

Gollum is the wiki engine that powers GitHub, but more importantly to me, it is also used in GitLab. I am jumping straight to it, because it encompasses all the features of a regular directory of text files, but does a better job on various points.

  • Git-based, text files, very simple and efficient.
  • Easy to use with other workflows.
  • Markdown with smart extras.
  • Can be edited via web or text file.

But some features completely missing.

  • No taxonomies outside of folder structures, goes against emergence of patterns and cross-referencing I enjoy.
  • Links are not as easy to pull off.
  • Search is kinda dependent on larger system, which is iffy at best.

There is one thing that using a self-hosted git repo has that is very interesting: task management. The ability to track some thoughts as tasks that can be sorted, labeled, commented on and closed is very appealing, and will probably be used in note-taking regardless; closeness of tools in that capacity are a benefit.


Finally, WordPress. My career is more or less based on WordPress, so here are the advantages of using it for note-taking and sharing.

  • I’ve got Markdown (this very post is written in it).
  • I love the way taxonomies work in WordPress.
  • I’ve got a lot of options for search, due to my work providing hosting for very large WordPress sites.
  • I theme in my sleep (it’s a problem), so I can make the content look however I want, no lock-in.
  • It is very public, and I already plan on publishing updates in blog posts for insights I come upon, so it is already part of the process.
  • URLs are robust and sane.

On the other hand…

WordPress feels like publishing to me. This is silly, I know, so please comment on this: I want my notes to be found and feedback submitted, but I don’t want to present my unfinished thoughts as something worthy of being in my primary publishing pipeline (or 3P as I am calling it starting now).

I am already coming up with reasons that I shouldn’t care about this. Am I so concerned with SEO that I would go against my authentic self and try to separate a half-formed idea or preliminary research from how folks perceive me on the web?

What if I am walling myself into this single project, and everything looks like a nail to my WordPress hammer? Is the novelty of WordPress gone for me? Am I searching for a reason to use a different tool because I don’t think WordPress can handle it, or because I just want to try something else?

At the end of the day people work with me because they know me, or know someone else that knows me. I benefit greatly from presenting who I am upfront, so any fear I have around showing these other parts of myself doesn’t appear justified.

Wrapping it up

Okay, so I feel a bit better. Despite kinda processing that and realizing I am compounding my distraction by avoiding the tool I am most comfortable with, I’d still like to here your thoughts on this. Did I miss anything, or misunderstand how something works? Because I would love to know there is a specialized tool out there to do this thing for me.

And finally, what is a blog? It isn’t like I would type up shorthand notes, so anything I write will be legible to at least myself for future reference. Should I just blog my notes and categorize them as such? If I typed up fifty pages in one day, would that seem like spam, or is there an argument that such diligence in record-keeping is beneficial in this era of 140 character half-thoughts? Can a blog serve as externalized memory, while still providing useful information to others?

If you have answers, let me know. ^_^

Rebooting my free services

I have a strong compulsion to emulate large, centralized platforms. I think it irks me to collaborate with others on sites that are owned by for-profit companies, because their rules are derived from the bottom line, and that is a community anti-pattern.

Or I was hypnotized as a child. I am not ruling that out, and will probably be leaning on it as an excuse to explain more of my behavior in the future. ^_~

Anyhow, I find myself assessing my network assets, and I have a lot going on. Some of the services I run are useful (like the talkgroup), but others are not utilized as I imagined they would be. Phabricator and GitLab come to mind.

Because I keep notes, I know my motivation in setting these up. I want free software and community resources available to folks that I don’t think would use them otherwise. Specifically, my friends. I like servers, and I like devops (see hypnotizing theory above), but not everyone has my time or skillset to spin up a site. So I figured I would do that, and folks wouldn’t need to default to the mainstream alternative that uses them as the product.

But as it turns out, the primary folks that use these services are people that could do it themselves. And everyone else is either not interested, or have activation inertia towards the mainstream.

I’ve known all this for a while, of course. It just didn’t deter me. But now I am seeing the return on investment in terms of time, and I’d like to spend that elsewhere. I want to make more impact, and I think cutting back on some services will free up the mental energy to produce some new projects I have in mind.

Specific sites and services

I will transition All the codes! away from GitLab. I am tired of being a second rate citizen with their “open core” model, and my host that was absorbed by the GitLab company is no longer dedicating enough resources to my instance, making it crawl along. Too many straws, so away it goes. Since I just need a web viewer and something that is fast, I am considering Gogs.

guildworks is complicated, because I really like the software, but I don’t develop software the way they do (meaning, I don’t really collaborate). I really love the way tasks work there, and I haven’t found anything similar, but it seems silly to keep that up just for that relatively small component.

I was going to run another community jabber server, but the admin for that is so prohibitive I am going to avoid it. Instead, to encourage federation and decentralization, I am going to create a node on interi.org, and will have a rolling project slot for helping others setup Prosody.

I’ve been thinking about wikae a lot lately, but I no longer think documentation should default to public editing. MediaWiki hits this niche that I don’t use, so I will be finishing off maiwiki. Instead of going through piecemeal as I’ve been, I will be exporting it as a whole into a static site generator, for archiving. Note: I have some exciting develops in documentation coming up!

I am keeping Discourse up because we use it often enough, and it is great software. But I am running it as a listserv (with a really great web interface), but I am not looking to integrate other sites into it. I want it to be great as its thing, which is sharing info for discussion.

And finally I am clearing the table for planned social network things. I don’t think the federated social network model works, and I don’t think anything that could scale against the mainstream can remain free and open. Instead I want to build recipes for specific social tools, which server me and my tribe, and which can be easily emulated for others.

And that’s it. Cleaning up, re-focusing. If you have any concerns about the sites I’ve mentioned, leave me a comment or email me. And let’s get a cup of tea sometime. ^_^

New wiki notice

I sent this out to the users that registered with an email address on maiwiki:

Hiya! This is maiki, the one that runs this wiki. I recently found that the database has so many bot registrations, it is now 17GB! While we don’t have an issue with spam in the articles, I did run out of hard drive space, so I am going to start over with a new wiki instance.

My plan is to migrate all the content over from this wiki to a new one, and turn off user registration. I will manually add folks to the wiki that wants to edit it, which has only been a handful of us, and that should take care of it.

I would also like to relicense everything under CC0 (http://creativecommons.org/about/cc0). The current wiki is CC-BY-SA. The reason is that most of the content on the wiki is created by me, and I want to dedicate it to the commons.

If you do not want your content relicensed with CC0, please let me know and I will remove your contributions from the new wiki. ^_^


Locking down the wiki

I thought about it for a day, and decided to set the wiki to only be editable by those with a confirmed email address. The main reason is that I don’t have time to fight spam now, and this may help. It isn’t a permanent decision, though I fear that I may just leave it like that out of frustration.

Eventually I hope to find a different method for combating spam, and if I went ahead with my plans for a wikae cluster and filled it with active communities, it might work. I’ve got to think about this, but I don’t have the energy to do so now.