docs: bring up to date with major changes