wip docs & fixes