Fungible Token and Non-Fungible Token example docs are out of date

[leighmcculloch]

What version are you using?

e8416b6

What did you do?

Viewed the current Fungible Token, Non-Fungible Token, and Tokens example pages, whose OpenZeppelin samples target stellar-contracts.

What did you expect to see?

Links that resolve and code that compiles against the current OpenZeppelin crates and encouraging best practices.

What did you see instead?

The Fungible Token page points at examples/fungible-token-interface, which no longer exists in the OpenZeppelin repo, so its links and clone/test/build steps are out-of-date.

The code has drifted (e.g. pausable moved from stellar_pausable to stellar_contract_utils::pausable); macros and composition have changed as default_impl is no longer used.

The NFT page's nft-sequential-minting example is also out-of-date.

The Token example page is old and out-of-date with the latest soroban-sdk.

[leighmcculloch]

We should probably rethink the tokens examples pages holistically.

The token example is pretty complex and so for most people jumping in, it's probably not the best place to start, although it is still important as it shows you how to build a token with no framework.

The OZ fungible example targets soroban_sdk::token::TokenInterface, which isn't how most people use the OpenZeppelin libs so it's a bit odd to focus on that here. Their fungible-vault (basic) and fungible-pausable (customised) examples are closer to real usage.

OpenZeppelin's own token docs have really good and easy to follow examples for how to use their libs so maybe we just need a tip box on the Tokens example linking out to them. So we show an example of how to build it yourself, or the fast path is go to OZ's docs and use that simple example:
https://docs.openzeppelin.com/stellar-contracts/tokens/fungible/fungible

[leighmcculloch]

cc @briwylde08 @ElliotFriend @sisuresh @mootz12 @dmkozh

[mootz12]

So we show an example of how to build it yourself, or the fast path is go to OZ's docs and use that simple example

+1, we shouldn't duplicate their examples. It will just eventually get out of date again. Our examples should try and rely on only the soroban-sdk, as most people reading them probably aren't trying to build a basic token, but just want an idea of syntax.

[leighmcculloch]

Our examples should try and rely on only the soroban-sdk

👍🏻

I've opened a change doing this:

• Remove OZ token example pages, link to OZ docs #2705