Yeah, back at the beginning of this exercise, Alvaro wondered aloud if we should go to something other than tables altogether. I dunno what that'd look like though.
It would probably look like our acronyms and glossary pages.
Maybe the return example and return values get replaced with a programlisting?