[CONTENT SPRINT] FDA 21 CFR Part 11 Evidence Patterns with Pulumi#18955
[CONTENT SPRINT] FDA 21 CFR Part 11 Evidence Patterns with Pulumi#18955sicarul wants to merge 6 commits into
Conversation
Docs Review: FDA 21 CFR Part 11 Evidence Patterns with PulumiThanks for the submission! The blog post itself is thoughtful and avoids overclaiming compliance, which is the right tone for a regulated-industry topic. However, this PR has a critical issue with files that should not be committed that needs to be resolved before this can merge, plus several smaller style fixes. 🚨 Blocking: Internal/sensitive files accidentally committedThe PR includes 20+ files that have nothing to do with the blog post and contain internal customer/sales data:
This content is not appropriate for a public repository. Please:
Until those files are removed, the rest of the review below is moot — please don't merge. Blog post content review (
|
Social Media Reviewcontent/blog/fda-21-cfr-part-11-compliance-with-pulumi/index.mdX — PASSLinkedIn — PASSBluesky — PASSSuggestions (advisory)These are stylistic notes — they don't block the post. X
Bluesky
Updated for commit |
|
Your site preview for commit 67b4c05 is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-18955-67b4c05e.s3-website.us-west-2.amazonaws.com |
bf2e7c9 to
d1b40c4
Compare
d1b40c4 to
cca1990
Compare
|
@claude please review again. I rewrote this branch history to a single clean commit on current |
|
Claude finished @sicarul's task in 1m 46s —— View job Re-review: FDA 21 CFR Part 11 Evidence Patterns with PulumiThanks for the cleanup — the PR diff is now clean (3 files only) and the social frontmatter is fixed. The earlier blockers are resolved. A few smaller items from the prior review still apply.
✅ Resolved from prior review
❗ Still outstanding from prior reviewThese items from the previous pass don't appear to have been applied. The first two are repo style-guide rules ( 1. Heading case — H2+ must be sentence caseSeveral H2 and H3 headings are still title case (
2. Ordered list numbering — every item should start with
|
|
@claude please review again. Branch history is now a single clean commit on current origin/master. The PR diff contains only content/blog/fda-21-cfr-part-11-compliance-with-pulumi/index.md plus feature.png and meta.png. Social-review is passing, and actionable content feedback has been addressed. |
|
Claude finished @sicarul's task in 1m 45s —— View job Re-review: FDA 21 CFR Part 11 Evidence Patterns with Pulumi
✅ Confirmed from prior review
❗ Still outstanding — same items as last passApologies — you mentioned "actionable content feedback has been addressed," but the four content items called out in the last review look unchanged in 1. Heading case (style-guide rule — AGENTS.md: H2+ = sentence case)All eleven flagged headings are still title case:
2. Ordered list numbering (style-guide rule — AGENTS.md: every item begins with
|
|
@claude please review again. This request is after the latest pushed head commit |
|
Claude finished @sicarul's task in 1m 12s —— View job Re-review: FDA 21 CFR Part 11 Evidence Patterns with Pulumi
✅ Confirmed clean
❗ Still not applied — same content items as the previous two passesYou've now said three times that content feedback was addressed, but 1. Heading case (style-guide rule —
|
| Line | Current | Should be |
|---|---|---|
| 39 | ## Understanding 21 CFR Part 11 in the Cloud |
## Understanding 21 CFR Part 11 in the cloud |
| 49 | ## Mapping Pulumi to Part 11 Controls |
## Mapping Pulumi to Part 11 controls |
| 53 | ### 1. System Validation (11.10(a)) |
### 1. System validation (11.10(a)) |
| 60 | ### 2. Audit Trails (11.10(e)) |
### 2. Audit trails (11.10(e)) |
| 71 | ### 3. Record Protection and Retrieval (11.10(b) and (c)) |
### 3. Record protection and retrieval (11.10(b) and (c)) |
| 78 | ### 4. Authority Checks (11.10(g)) |
### 4. Authority checks (11.10(g)) |
| 87 | ## Configuring Audit Trails for Regulated Workloads |
## Configuring audit trails for regulated workloads |
| 179 | ## Neo-Assisted Compliance and Documentation |
## Neo-assisted compliance and documentation |
| 183 | ### Generating Validation Documentation |
### Generating validation documentation |
| 189 | ### Continuous Compliance and Drift Detection |
### Continuous compliance and drift detection |
| 193 | ## Enforcing Audit Trail Controls with Pulumi Policies |
## Enforcing audit trail controls with Pulumi Policies (product name stays capitalized) |
2. Ordered list numbering (style-guide rule — AGENTS.md: every item begins with 1.)
Lines 44–47 still use 1./2./3./4.:
1. **Validation**: Ensuring systems are accurate, reliable, and perform consistently.
1. **Audit trails**: Computer-generated, time-stamped records of all actions.
1. **Record protection**: Ensuring records are retained and can be retrieved throughout their retention period.
1. **Authority checks**: Ensuring only authorized individuals can access the system and perform actions.
Markdown still renders 1/2/3/4. Labels sentence-cased to match the heading fix.
3. Redundant intro (lines 33 + 35)
Both paragraphs open with "In this post…" and line 35 partially restates the closing disclaimer at line 227. Suggested collapse:
In this post, we will explore how Pulumi features map to Part 11 controls and how you can use Infrastructure as Code (IaC) to see how to structure a compliance evidence workflow for your regulated workloads. While the tools illustrated below support compliance efforts, they do not provide automated certification or guarantee regulatory approval — see the closing disclaimer for the full caveat.
"You will build a compliance evidence workflow" still overpromises — the post illustrates two snippets (CloudTrail provisioning + a policy pack) rather than walking the reader through an end-to-end build. Use "structure" or "see how to structure."
4. Missing CTA
The post still ends on the disclaimer at line 227 with no next step. Add a {{< blog/cta-button >}} before the disclaimer pointing at /docs/insights/policy/ or /product/pulumi-cloud/.
If something about my proposed wording isn't right — e.g., you want to keep the explicit "Note that while Pulumi tools support compliance efforts…" sentence in the intro — just say so and I can adjust. But the headings and the ordered-list normalization are style-guide rules in AGENTS.md, not preferences, and they need to land before merge.
Nice-to-have (still optional, unchanged)
- Tags:
neo→pulumi-neoif you want this post to surface alongside10-things-you-can-do-with-neo/. - Conclusion hedging (line 225): "Pulumi provides tools that can help build and manage infrastructure in alignment with…" is still a stack of hedges. Optional but worth a pass.
- Policy import idiom (line 199):
import { Trail } from "@pulumi/aws/cloudtrail";works, but the canonical CrossGuard pattern isimport * as aws from "@pulumi/aws"; validateResourceOfType(aws.cloudtrail.Trail, ...). - Policy semantics (lines 207–215):
if (!trail.x)treatsundefinedas a violation, which is correct — worth one sentence of prose calling that out for readers.
Publishing readiness
- Accidental files removed
- Social frontmatter formatted (and social-review bot PASS on all three platforms)
- `` present
- Author profile resolves (
data/team/team/pablo-seibelt.toml) - Internal links resolve
- Title 51 chars / meta_desc 148 chars
- Headings sentence-cased (style-guide blocker)
- Ordered list normalized to
1.(style-guide blocker) - Intro tightened / overpromise softened
- CTA added
- Final
meta_imagefrom Design (needs-designlabel)
If you'd like me to apply these four fixes directly to the branch, reply @claude please apply the heading / list / intro / CTA fixes and I'll push a commit. Otherwise this is ready to wait on Design as soon as those style-guide items land.
• Branch: blog/fda-21-cfr-part-11-compliance-with-pulumi •
|
@claude please review again. This PR is now marked as draft, the needs-design label has been removed, and the latest pushed head is |
|
Claude finished @sicarul's task in 54s —— View job Re-review: FDA 21 CFR Part 11 Evidence Patterns with Pulumi
Status
Reading the stateThe branch is in a good shape to sit in draft:
I won't repeat the full heading table a fourth time — line-by-line details are in the previous review. When you're ready to take this out of draft, the two style-guide items are the gating ones. If you'd like me to apply the four fixes directly to the branch, reply • Branch: |
|
🤖 @sicarul — pinned review cleared; regenerating from scratch. |
|
@claude #new-review |
|
🤖 @sicarul — pinned review cleared; regenerating from scratch. |
eacee25 to
1561c04
Compare
|
@claude #new-review |
Pre-merge Review — Last updated 2026-05-19T04:10:00ZReviewing a draft; findings may change as you iterate. Tip Summary: This PR adds a new blog post ( Review confidence:
Investigation log
🔍 Verification trail43 claims extracted · 14 verified · 21 unverifiable · 1 contradicted
Claim verification reported errors — some verdicts may be incomplete; spot-check the affected claims in-review. 📊 Editorial balanceSingle-subject post; balance check N/A. The "Configuring audit trails for regulated workloads" section runs 155 lines (11.9× the section-length median) — this is a Tier 3 don't-flag exception: the section is the post's core code example for a single-subject technical walkthrough, and contracting the listing would reduce reader value. Vendor-mention pattern is also single-subject as expected for a Pulumi-authored post; no competitor steering or false-balance prompts in the FAQ-style "Neo prompt" block. 🚨 Outstanding in this PRThese must be resolved or refuted before merging. No outstanding findings. Ready to merge once the draft is marked ready and any desired low-confidence spot-checks are addressed.
|
|
🤖 Review regenerated on @sicarul's request. |
|
@claude #update-review |
|
🤖 Review updated on @sicarul's request. |
Why this content is interesting
What we took into account
Why it is useful to an end user
Design need
needs-designbecause the post needs a final meta image before publication.feature.pngandmeta.pngfiles are placeholders unless Design chooses to reuse or adapt them.Metadata
🤖 Generated with OpenCode