Idea is to emphasize usage of delegating transformers when people want to i18nize complex fields. => https://documentation.magnolia-cms.com/display/DOCS/_Complex+fields+with+i18n
Optionally, I would also demote most other complex-field transformers (the non-delegating ones), by moving them to a sub-page. => https://documentation.magnolia-cms.com/display/DOCS/Non+delegating+complex+field+transformers
Original page (via wiki link):
Finally: the include may be used on all 3 complex-field documentation pages too:
There, the "best practice" block needs to be removed, while emphasizing delegating transformers in the transformerClass reference.