[WIP] Refactor docs

Fix #94.
theoretically you could do params_expression (or param_expressions?). and then even merge the two. if that is no big pain, we might actually want to do that to avoid that WTF moment when a name hits a parameter name. doing it later would be a BC problem...