twister: update harness docs

Refine harness docs and move configuration options for each harness into
own section for clarity.

Signed-off-by: Anas Nashif <[email protected]>

Author: nashif