* docs: general improvements and updates * fix vale error
(Should be merged after the next release) Closes DX-1294