docs: improve RBAC deployment script documentation and doc comments

[Martinsbab]

Closes #495.

Summary

This pull request improves the documentation and overall code quality of the RBAC deployment script.

Changes

• Updated deployment script documentation.
• Added and improved NatSpec comments.
• Improved inline comments for readability.
• Aligned formatting with repository standards.
• Removed outdated or misleading documentation.
• Improved consistency with similar deployment scripts.

Validation

• Documentation reviewed for accuracy.
• Formatting verified.
• Linting completed with zero warnings.
• Existing functionality preserved.
• No business logic changes introduced.

Scope

This PR only contains documentation and code-quality improvements related to the RBAC deployment script.

Closes #495

[drips-wave]

@Martinsbab Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits