Skip to content

docs: clarify resource identity and add community blog post#308

Merged
mathieu-benoit merged 2 commits into
score-spec:mainfrom
ShantKhatri:update-provisioner-resolution-and-blog
Jul 6, 2026
Merged

docs: clarify resource identity and add community blog post#308
mathieu-benoit merged 2 commits into
score-spec:mainfrom
ShantKhatri:update-provisioner-resolution-and-blog

Conversation

@ShantKhatri

@ShantKhatri ShantKhatri commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

What is the motivation?

The current documentation does not explicitly detail how resource UIDs are constructed or how identity matching works under the hood. Clarifying this process helps developers understand how to correctly use the id field and realize that "shared resources" are simply the result of identity matching rather than a separate primitive in the spec. Additionally, we want to surface a recent community blog post that dives deep into this resolution process.

What does this change do?

  • Adds a new Resource identity section to resources-provisioners.md for both score-compose and score-k8s. This section clearly breaks down how a resource UID is constructed (type.class#workload_name.resource_name) and explains the behavior of the id field.
  • Adds the recent blog post "Anatomy of a score.yaml: How Resolution Actually Works" to the external blog posts list in content/en/docs/community/_index.md.

What is your testing strategy?

  • Verified that the markdown renders correctly.
  • Confirmed that the added blog post link in the community index resolves successfully.

Is this related to any issues?

No. Adding these has been discussed with @mathieu-benoit over Slack.

Have you read the Contributing Guidelines?

@ShantKhatri ShantKhatri marked this pull request as draft July 6, 2026 11:30
Signed-off-by: Prashantkumar Khatri <khatri2105104@st.jmi.ac.in>
Signed-off-by: Prashantkumar Khatri <khatri2105104@st.jmi.ac.in>
@ShantKhatri ShantKhatri force-pushed the update-provisioner-resolution-and-blog branch from a7c38af to 0c0e411 Compare July 6, 2026 11:31
@ShantKhatri ShantKhatri marked this pull request as ready for review July 6, 2026 11:32
@mathieu-benoit mathieu-benoit self-requested a review July 6, 2026 12:38

@mathieu-benoit mathieu-benoit left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, great clarification and addition, thanks @ShantKhatri!

@mathieu-benoit mathieu-benoit merged commit 3cbb9d8 into score-spec:main Jul 6, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants