ksgen: doc update

The main change is adding a schematic example for the config-dir.
The rest are mainly costmetic ReST syntax changes.

Change-Id: I65e04a5fae41efc9c47d1a025e6007c277168704