docs: fix descriptions and links (#764)