Extracted from:#5574

The goal of this issue is to describe rich parameters and document all related properties, types, validation, etc. The documentation should also contain guidelines on how to migrate from old parameters to new ones.