[Backport release-3_34] qgsvectorlayer.h: move a documentation section to the appropriate place

[Backport release-3_34] qgsvectorlayer.h: move a documentation section to the appropriate place #26489