docs: add json example
averez-doc: document JSON structure
averez-doc: add "What should I log?" section
averez-doc: fix links
averez-doc: configuration snippet for beaver-syslog
averez-doc: fix beaver-syslog snippet and add heka-syslogng snippet
averez-doc: fix heka-syslog snippet and add heka-apache snippet
averez-doc: adding heka-lua-bro-notice and heka-lua-bro-intel configuration snippets
averez-doc: adding nxlog-syslog configuration snippet
Merge remote-tracking branch 'upstream/master' into averez-doc

Conflicts:
	docs/source/usage.rst
Merge pull request #32 from netantho/averez-doc

Shipping and JSON structure documentation