wso2 / wso2/docs-api-platform

[Missing-Docs]: For users who want to create custom roles, there should be documentation defining which scopes serve which purpose.

Open Beginner friendly
#455 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Priority/Normal Severity/Major Type/Docs Type/Improvement
Dominant language
HTML
Stars
2
Forks
64
Avg merge
1d 9h
Merged PRs (30d)
34

Description

What's missing?

https://wso2.com/api-platform/docs/ai-workspace/1.0.0/setting-up/authentication/overview/#add-more-users
The above documentation explains how authentication works in AI Workspace and how to add users with custom roles. However, to define custom roles, users need to know which scopes are available and what each scope is used for. It would be better to add a separate document that explains the available scopes and their purposes.

Related Section

AI Workspace

Where did you expect to find it?

No response

Related Issues / Links

No response

Suggested Labels

AI Workspace

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the AI Workspace authentication overview at the linked documentation URL and inspect the repository’s corresponding documentation structure. Add a separate page listing the available scopes and explaining each scope’s purpose, so users can define custom roles; done means the scope choices and their meanings are clear.

Written by the indexing model from the issue text.

Assessment

Domain
authentication, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.