identity service: documentation

[adecaro]

The available documentation about the identity service (token/services/identity) is available under docs/services/identity.md. This Issue asks to double check that it matches the code and enhance it with examples of how to extend it.

[sid200727]

Hi, I’d like to help improve the documentation for the identity service.
I’m currently reviewing the existing docs and would appreciate any guidance on specific areas that need clarification or expansion, or any expected scope for this task.

[adecaro]

@sid200727 , thanks a lot for offering your time. I have added a description.
Please, let me know if it clarifies the task.
Many thanks.

[sid200727]

Hi @adecaro,

I’ve opened a PR addressing this issue. The update:
• Clarifies how the Identity Service can be extended
• Adds a structured section on extension scenarios
• Includes a simple custom identity provider example

PR: #1326

Happy to adjust anything based on feedback. Thanks!