Skip to content

docs(operations): allow CNCF Case Study as adopter interview substitute - #2282

Merged
angellk merged 3 commits into
cncf:mainfrom
angellk:feat/case-study-substitution
Aug 27, 2026
Merged

angellk merged 3 commits into
cncf:mainfrom
angellk:feat/case-study-substitution

Conversation

@angellk

@angellk angellk commented Aug 22, 2026

Copy link
Copy Markdown
Contributor

Summary

Extends the adopter interview substitution guidance added in #2256 (now merged) so that both a published TAB Reference Architecture and a published CNCF Case Study may serve in place of an individual adopter interview.

Adds that it is at the TOC sponsor's discretion during the Due Diligence to determine whether the Reference Architecture or Case Study meets the necessary standards and includes the requisite information the Due Diligence requires to determine whether the project meets the requirements of the level in process.

Changes

  • operations/dd-toc-guide.md: updated the substitution note in the Conducting Adopter Interviews section to cover Case Studies alongside Reference Architectures, and to state the sponsor-discretion standard.

Test plan

  • Verify markdown renders correctly
  • Confirm the CNCF Case Study guidelines link resolves
  • Confirm the TAB Reference Architecture link resolves

Extends the adopter interview substitution guidance (cncf#2256) so a
published CNCF Case Study, in addition to a published TAB Reference
Architecture, may serve in place of an individual adopter interview. It is
at the TOC member's discretion who is leading the Due Diligence for Moving
Levels to determine whether the Reference Architecture or Case Study meets
the necessary standards and includes the information the Due Diligence
requires.

Signed-off-by: Karena Angell <karena.angell@gmail.com>
@angellk
angellk force-pushed the feat/case-study-substitution branch from f01b57f to 4c8c2c3 Compare August 22, 2026 01:46
@jrsapi

jrsapi commented Aug 23, 2026 •

Copy link
Copy Markdown

Looks good overall; I have one requested change before merge.
The existing note cautions that interviewees may be project maintainers or governance participants rather than operational users. The same issue can arise with a Reference Architecture or Case Study: it might describe the project team’s or a vendor’s work without showing an independent adopter’s operational use.
Could we add language asking the TOC member to make that same check when using either as an interview substitute?
Suggested addition: “When evaluating a Reference Architecture or Case Study, the TOC member should confirm that it demonstrates an independent organization’s operational use of the project, rather than relying solely on the project team’s or a vendor’s account.”
LGTM otherwise.

…udy substitutes

Address jrsapi review on cncf#2282: apply the same independence check used
for interview participants when a Reference Architecture or Case Study
substitutes for an adopter interview, so the evidence reflects an
independent organization's operational use rather than the project
team's or a vendor's account.

Signed-off-by: Karena Angell <karena.angell@gmail.com>
@angellk

angellk commented Aug 24, 2026

Copy link
Copy Markdown
Contributor Author

Thanks @jrsapi - good catch. I've added your suggested language so the same independence check applies to substitutes:

When evaluating a Reference Architecture or Case Study, the TOC member should confirm that it demonstrates an independent organization's operational use of the project, rather than relying solely on the project team's or a vendor's account.

Pushed in 527d08b. I also mirrored it to the contribute-site guide and the announcement blog (cncf/contribute-site#397) to keep the two in sync.

@jrsapi jrsapi left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM

Comment thread operations/dd-toc-guide.md Resolved
Per review feedback, remove the first two sentences of the Reference
Architecture or Case Study substitution note. They qualified the content
rather than being content, and read as abstract in the full guide. The note
now opens directly with what may substitute for an adopter interview.

Signed-off-by: Karena Angell <karena.angell@gmail.com>
@angellk

angellk commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

merging per @brandtkeller and @jrsapi lgtm

@angellk
angellk merged commit 61af5ec into cncf:main Aug 27, 2026
1 check 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.

3 participants