wip: mark docs section that need reworking