Improve the discoverability of examples documentation for better DX

[sanchitmehta94]

• All new/changed/fixed functionality is covered by tests (or N/A)
• I have added documentation for all new/changed functionality (or N/A)

📋 Changes

Previously, EXAMPLES.md contained comprehensive code samples but was nested deep within the README, making it easy for users to miss.

This change improves discoverability by:

1. Adding a dedicated “Examples” section in the top navigation, placed next to Getting Started
2. Introducing a clearly labeled Examples header (with icon) that links directly to the examples section
3. Surfacing key Swift SDK examples directly in README.md for quick access
4. Providing a clear link to the full EXAMPLES.md document for deeper reference at the bottom of example section this makes the better discoverable linking to Example.md file

This structure makes examples easier to find, faster to scan, and more approachable—improving the overall developer experience

📎 References

🎯 Testing

https://github.com/auth0/Auth0.swift/tree/DX/improvements

[pmathew92]

nit: I think this sentence can be improved. Somethinkg like:
" Retrieve the stored credentials from the Keychain. If the credentials have expired, they will be automatically renewed using the refresh token"

[sanchitmehta94]

done

[pmathew92]

Add a note also saying something like
"It is recommended to clear all saved credentials when the user logs out of the application"

[sanchitmehta94]

Done, Added a note recommending this API be called on logout.
Currently, there is no API to clear the APICredentials introduced for the MRRT flow. having a unified clear-all API which a breaking change, planned in the next major Swift release.