kcp
kcp copied to clipboard
kcp-dev
docs: workspace (type) documentation is outdated
Describe the bug
Our docs at https://docs.kcp.io/kcp/v0.26/concepts/workspaces/ seem really really outdated:
- The workspace type reference in the example YAML is no longer valid as far as I can say from the spec.
- We don't document workspace type references at all, making it clear that they can be cross-workspaced AND require RBAC (see https://github.com/kcp-dev/kcp/blob/main/config/root/clusterrole-workspacetype-use.yaml for an example).
- Do home workspaces even work the way they're documented? Are buckets still a thing? I don't seem to see a "full path" when I use a home workspace, just a logical cluster name.
Steps To Reproduce
- Go to docs and try to make sense of them.
Expected Behaviour
Docs should reflect the current situation and document how to use things.
Additional Context
Issues go stale after 90d of inactivity.
After a furter 30 days, they will turn rotten.
Mark the issue as fresh with /remove-lifecycle stale.
If this issue is safe to close now please do so with /close.
/lifecycle stale
Issues go stale after 90d of inactivity.
After a furter 30 days, they will turn rotten.
Mark the issue as fresh with /remove-lifecycle stale.
If this issue is safe to close now please do so with /close.
/lifecycle stale