Skip to content

Personal wiki system

dchudz edited this page Sep 1, 2013 · 1 revision

Two tools that I think have been very important in Kaggle's culture are our team wiki, and our version of the Stack Exchange Data Explorer. The wiki is a really nice, light-weight store of useful stuff. If we're sending an email to a group of team members with information that will continue to be useful, we put it in a team wiki page and send them the link instead. It's not always up-to-date, but even old pages are great as a record of what we were thinking at the time. (Kaggle has a public wiki running the same software (which custom-built by Adam Kennedy as his first project at Kaggle) -- the public wiki gets some use, but a lot less.

I'd like the same thing for myself. I'm just one person, but collaborating with my future self is a lot like collaborating within a team. (Maybe not everyone is like this, but I have a very bad memory.) I would also like a wiki for collaborations in my personal life.

But I'm very spoiled by Kaggle's wiki software and haven't found anything nearly as good for myself. Nice features:

  • it's lightweight
  • automatically formats/highlights code
  • LaTeX integration via MathJax
  • relative paths for internal links ("[.ChildPage]") with all child pages listed at the bottom of a page (Chris Clark added this feature and it's been more important than you'd think)

I haven't found any software I'm really happy with for a personal wiki, so I've just started typing things on Github. Since the wiki is represented as a bunch of text files in a git repository, it should be very flexible. One solution might be to keep editing it here, but have some markdown-renderer running on a server that stays in sync with the version on Github.

With support for LaTeX, Github itself would be good enough.

A few days after I started writing things down here, I learned about Bill Seitz' personal wiki.