Name a website that impressed you

I am starting to plan out a new design for my website. After some soul searching I realized that my ideas won’t fit into a pre-existing WordPress theme, and I need to start building one.

I am pretty clear on how I want posts and custom content to look and feel, and of course I will endeavor to make it as accessible and useful as possible. Once I get a repo going I will share that.

There is one aspect that I can’t quite decide, though, and that is landing or informative pages. Specifically, I don’t know how I want the front page to look. I want it to be easy to read and serve as a launching point for the different sections on my site, with a strong emphasis on the work and play that is my life.

I started looking at websites that I frequent, but I wanted broader exposure to what folks find useful or pretty or interesting or maybe just something that stood out for them.

So please, share with me an inspirational design. Or something tragic and ugly that must be avoided at all costs. Leave a comment or email me at ^_^

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. ^_^

Disable session cookies in Pods

We were having trouble on a site that has a lot of traffic, with PHP timing out, and the web server not recovering. It was odd, because the site doesn’t have very much interactive parts, and in mostly served from the cache… except it wasn’t being cached at all!

The site makes heavy use of Pods for custom post-types, and that is hardly an issue, but in this case Pods was setting a session ID via cookie, which of course meant each time a page is visited it is “new”, and bypasses the cache. Suddenly our high volume of traffic is hitting the database and rendering each page on every load, and honestly I was surprised it survived for as long as it had.

My research turned up two issues that were relevant: Replace all session and session_id usage #2237 and 2.4.3 prevents browser caching #2542.

#2237 refers to a change that could possibly fix this issue, but is ongoing. #2542 contains the fix, though I wasn’t able to track where it came from, as it wasn’t provided in the referenced conversation.

define('PODS_SESSION_AUTO_START', false);

Because I couldn’t source this seemingly undocumented config, I hopped on the Pods Slack instance, where Jim True and Bernhard Gronau verified that it was exactly for this use case. Pods has a feature I don’t use, wherein one can produce a front-end form to submit content directly into a Pods-created post-type, and the sessions are a security feature.

Turning off the sessions did the trick, and soon the site was being delivered from the cache.

Bonus tip

In discussing the Pods forms, I mentioned I used Gravity Forms, with the Gravity Forms + Custom Post Types plugin. They recommended Pods Gravity Forms Add-On. When I asked about the difference, they explained the Pods add-on can handle relationship fields. That is very cool! ^_^

WordPress 4.6 Beta 1 and feature freeze

Hey! WordPress 4.6 is cranking along, and a feature freeze and beta has dropped.

There are two big sub-projects in this release: Font Natively and Shiny Updates.

Font Natively reverses what I’ve always considered the mistake of linking to Google Fonts in the WordPress admin pages. One of my essential plugins has always been either Remove Google Fonts References or Disable Google Fonts, to remove those links. I am very happy this embarrassing mistake is being fixed.

Shiny Updates make the experience of updating themes, plugins and WordPress core a more enjoyable and straightforward process, in line with expectations for modern software. This is polish, follows WordPress’ principles of “designing for the majority, and striving for simplicity”. It will also make it a slightly better experience for those of us that run updates habitually (though I’ve largely moved to using Advanced Automatic Updates or WP-CLI myself).

This will be a fun update! Do you have any wish(list)s for future WordPress releases? I am always curious what folks are looking for. ^_^