Including the keymap in the description seems to be the convention. I usually use C-h m (describe-mode) to stumble across cool things major modes can do that I didn't know about. Quickly scanning function names is way easier than quickly scanning a whole manual.
show keybindings in the mode description
Show keybindings in the mode description
Fair enough. The emacs24 branch already does this, though, by using define-derived-mode.
Use correct URL. Fixes #71