Support dictionary encoding in structures for FlightDataEncoder, add documentation for arrow_flight::encode::Dictionary (#5488)

* Add more detailed documentation for arrow_flight::encode::DicationaryHandling

* fix doc link

* Fix handling of nested dictionary arrays with DictionaryHandling::Hydrate

* clippy

* Handle large list and sparse unions

* use top-level fields

* PR comments

Author: thinkharderdev