- It is redundant to use `function' around `lambda'.
- It is semantically better to use `and' if the returned value
matters. `when' should be used if we only care about the
side-effects.
The convention calls for the first line to form a complete sentence.
Here we can achieve that in most cases simply by not beginning the
second sentence on the first line.
org-mode `#+BEGIN_EXAMPLE` blocks can (optionally) be tagged with a
language, so this will give them proper syntax highlighting on GitHub.
It still works when the language is unset, of course.
I ran into some issues with the un-prefixed `loop` combined with the `for` keyword. I think the issue is that newer versions of Emacs don't alias `loop` to `cl-loop` by default? I had to explicitly require `cl` to make it work.
Earlier Github did not recognize, for instance, "emacs lisp" as a
language, so an associative list was used to map unrecognized languages
to a similar recognized language. This is no longer necessary.