[ARTEMIS-3857] Few issues with federation documentation

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 2.22.0
• Component/s: Documentation, Federation
• Assignee: Unassigned
• Reporter: Ievgen Popovych
• Created: 10/Jun/22 15:38
• Updated: 12/Apr/24 05:17

Description

Documentation on federation seem to be outdated or broken in some places.

Some examples include:

• policy-set is not shown/used while it seems to be required
• in queue federation document, statement All of the configuration needed to establish the upstream links and the federated queue is in the downstream broker is given globally, but is only true for upstream configuration if I understand correctly.
• in queue federation document, in downstream federation section, statement The benefit of this is being able to configure everything for federation on one broker in some cases to make it easier, such as a hub and spoke topology. is a bit misleading (IMO) since it highly depends on topology and desired message flow direction... I would suggest rephrasing to emphasize that this is only beneficial in those cases and only for having configuration in one place as it does not influence connection establishment direction, etc.
• federation is not documented in Configuration Reference at all