Reword docs of shorthand syntax

* Remove "As alternative to JSON" clause
* Use the param types instead of value1, value2.  This is confusing
  when a key name is "value".