The documentation currently is not very clear when explaining the concepts [A] and [B]. It also isn't up to date with the latest changes that enabled features [C], [D] and [E]. This should be updated so that existing and new developers are aware of the full feature set and so they can more easily understand how to develop contracts in the ecosystem.
Sources: