Add documentation for ClarifaiRM retriever module

[sushmanthreddy]

Hello team! I've added documentation for the ClarifaiRM module, following our existing docs style. This should help users get started with Clarifai integration in DSPy.

What's included:

• Basic setup and configuration
• Authentication details (since Clarifai needs this)
• Core method documentation
• Lots of examples covering common use cases
• Error handling patterns (something I wish I had when first using it!)

The examples section is a bit longer than other RMs but I think it'll be really helpful for new users.

Would love your feedback, especially on:

• Is the examples section too detailed? Happy to trim if needed
• Did I miss any important use cases?
• Does the auth setup section make sense?

[arnavsinghvi11]

Thanks @sushmanthreddy ! This is really helpful documentation!

I left some very minor edits and formatting touches and LGTM to merge when you're ready!

[sushmanthreddy]

@arnavsinghvi11 can u pls review the pr ??

[arnavsinghvi11]

Thanks @sushmanthreddy . can we change the notes formatting to the one in this commit. Currently, it shows up as a block that requires people to scroll when we just want to display the full text. Thanks!

[sushmanthreddy]

@arnavsinghvi11 is this fine now ??