Hi @Chrissie,
It would be good to improve this experience to save other community members from what you went through.
Where would you have expected to see a note on the upgradeable version, so that we can look to add one there.
Linking the Contracts Ethereum Package OpenZeppelin SDK documentation has the following note:
Make sure you install
@openzeppelin/contracts-ethereum-package
and not the vanilla@openzeppelin/contracts
. The latter is set up for general usage, while@openzeppelin/contracts-ethereum-package
is tailored for being used with the OpenZeppelin SDK. This means that its contracts are already set up to be upgradeable.
There is also a discussion on how contracts and contracts-ethereum-package could be made into a single offering: