Re-arrange the example code to show the intent in a clearer manner.

While the example code is functional, it doesn't highlight the
dependencies between the lines as best it could.  The rearranged code
adds comments to help explain that producers write to 'addresses', that
'queues' are bound to an address and that client's read from a 'queue'.

Explaining this separation clearly is needed in order to understand
how to turn this example into a publish/subscribe model.
Merge pull request #1698 from gkopff/doc_8_2_a_simple_example

Re-arrange the example code to show the intent in a clearer manner.
added scale down management method
Merge pull request #1704 from clebertsuconic/upmaster

adding filter to TransferQueue
Merge pull request #1700 from andytaylor/master

added scale down management method
fix colocated fail-over tests; fix SnF-to-SnF scale-down
Merge pull request #1707 from jbertram/master-snf2snf

fix colocated fail-over tests; fix SnF-to-SnF scale-down
fix for https://github.com/hornetq/hornetq/commit/791551cf51294743833638435d66b0d9398a6ecb as dependencies were broken
Merge pull request #1709 from andytaylor/master-fix

fix for hornetq-tools broken dependencies
update HA docs
fixed scale down ack and added colocated tests to test suite run
Merge pull request #1710 from andytaylor/master-fix

fixed scale down ack and added colocated tests to test suite run
Merge pull request #1706 from andytaylor/master

update HA docs
HORNETQ-1371 - Fix table formatting in new HA document
HORNETQ-1370 - Setting String property to null on a Message breaks XMLExporter tool
Merge pull request #1713 from jbertram/master-exportnullproperties

HORNETQ-1370 - Setting String property to null on a Message breaks XMLEx...
Merge pull request #1712 from jbertram/master

HORNETQ-1371 - Fix table formatting in new HA document
HORNETQ-1372 & BZ1113908 - TopicControl.listDurableSubscriptionsAsJSON does not work with heirarchical topics
Merge pull request #1714 from jbertram/master

HORNETQ-1372 & BZ1113908 - TopicControl.listDurableSubscriptionsAsJSON d...
Revert "https://bugzilla.redhat.com/show_bug.cgi?id=1114973 - fixing org.hornetq.api.core.management.ObjectNameBuilder to return correct Object names..."

This reverts commit 55fc837c1056e1cb32f2cac974e4930b18a6214c.