docs: some updates for the recent changes
docs: fix another warning