Our Jekyll/permalink setup leads to illogical looking relative links, for example for a Markdown file in the same directory, we end up with (adjacent file)[../adjacent-file].
This works, but it makes it hard to use !Jekyll to browse the docs. GitHub is !Jekyll and should be a priority as soon as we've got the site up and stable.
(Using full URLs somewhat mitigates this, but finding a more complete solution would be better)