content/docs/overview/benefits.md (1)

59-59: Tighten phrasing for readability.

Line 59 can be simplified by replacing “in a transparent way” with “transparently.”

Suggested edit

-The design of OCM makes it easy to add new features, so anyone can suggest, review, and merge improvements in a transparent way. 
+The design of OCM makes it easy to add new features, so anyone can suggest, review, and merge improvements transparently.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@content/docs/overview/benefits.md` at line 59, Replace the phrase "in a
transparent way" with the single word "transparently" in the sentence that
currently reads "The design of OCM makes it easy to add new features, so anyone
can suggest, review, and merge improvements in a transparent way." to tighten
phrasing and improve readability; locate this exact sentence (containing "in a
transparent way") in benefits.md and update it to end with "transparently."

content/docs/overview/how-ocm-works.md (2)

95-95: ⚠️ Potential issue | 🔴 Critical

Replace malformed Signing bullet that breaks markdown lint.

Line 95 has invalid link/emphasis syntax and is the root cause of the MD037 pipeline failure.

Proposed fix

-- **[Signing] -- relref signing-and-verification-concept.md" ** — cryptographic integrity, explained.
+- **[Signing]({{< relref "signing-and-verification-concept.md" >}})** — cryptographic integrity, explained.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@content/docs/overview/how-ocm-works.md` at line 95, The bullet at "Signing"
has unbalanced emphasis and a malformed relref link causing MD037 failures;
replace the broken token with a properly formatted link and balanced emphasis by
using the relref target "signing-and-verification-concept.md" and ensuring the
surrounding asterisks pair correctly (e.g., make the text either bold or plain
and insert a correct relref link for "signing-and-verification-concept.md"), so
the line reads with valid markdown and the MD037 linter passes.

---

46-46: ⚠️ Potential issue | 🔴 Critical

Fix invalid relref shortcode syntax.

Line 46 uses (--- relref ... ---), which is not valid Hugo shortcode syntax and won’t resolve.

Proposed fix

-Read more about [how signing works](--- relref "signing-and-verification-concept.md" ---).
+Read more about [how signing works]({{< relref "signing-and-verification-concept.md" >}}).

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@content/docs/overview/how-ocm-works.md` at line 46, The markdown contains an
invalid Hugo shortcode in the link text: replace the broken snippet Read more
about [how signing works](--- relref "signing-and-verification-concept.md" ---).
with a proper Hugo relref usage for the target document (use the Hugo relref
shortcode for "signing-and-verification-concept.md" inside the link so the link
resolves correctly), updating the line in content/docs/overview/how-ocm-works.md
where that broken relref appears.