Improved design notes.

Signed-off-by: David Noble <dnoble@splunk.com>