docs updates
specs: fix deprecated requirements