CR-4641 OPENIG-317: Update documentation to use inlined objects

This patch addresses three issues:
OPENIG-313: Instead of labelling reference values as strings, call them references
OPENIG-317: Update documentation to use inlined objects
OPENIG-327: Update documentation to reflect that empty "config" fields are now optional

There remains some work for OPENIG-313, however.
This commit only resolves OPENIG-317 & OPENIG-327.

git-svn-id: https://svn.forgerock.org/openig/trunk@592 dbb9e58e-28e6-4ce0-90e8-f11d9605b710
Editorial fix: enable syntax highlighting in code example

git-svn-id: https://svn.forgerock.org/openig/trunk@593 dbb9e58e-28e6-4ce0-90e8-f11d9605b710