Skip to content

Conversation

@deadlypants1973
Copy link
Contributor

Summary

related to #22699

Screenshots (optional)

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

@deadlypants1973 deadlypants1973 requested review from a team, kennyj42 and ranbel as code owners June 4, 2025 15:33
@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Jun 4, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Updated the documentation for custom certificates to clarify the parameters used in the API calls.

  • Modified the parameter name from 'one' to 'key' in the API documentation for uploading MTLS certificates.
  • Clarified the description for the private key requirement in the custom certificate documentation.

Modified Files

  • src/content/docs/cloudflare-one/connections/connect-devices/user-side-certificates/custom-certificate.mdx
  • src/content/docs/cloudflare-one/identity/devices/warp-client-checks/client-certificate.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

Copy link
Contributor

@windsurf-bot windsurf-bot bot left a comment

Choose a reason for hiding this comment

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

💡 To request another review, post a new comment with "/windsurf-review".

<TabItem label="API">

1. <Render file="upload-mtls-cert" params={{ one: " ", cert: "root CA" }} />
1. <Render file="upload-mtls-cert" params={{ key: " ", cert: "root CA" }} />
Copy link
Contributor

Choose a reason for hiding this comment

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

The parameter in the <Render> component was changed from one to key. Please confirm that key is the correct parameter expected by the upload-mtls-cert file, as this change could affect the rendered output or functionality.

file="upload-mtls-cert"
params={{
one: "The private key is only required if you are using this custom certificate for Gateway HTTPS inspection.",
key: "The private key is only required if you are using this custom certificate for Gateway HTTPS inspection.",
Copy link
Contributor

Choose a reason for hiding this comment

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

The parameter name in the Render component was changed from 'one' to 'key'. Please confirm that the Render component expects 'key' and not 'one', as this could break the UI or documentation rendering if not updated everywhere.

inputParameters: param1
params:
- cert
- key?
Copy link
Contributor

Choose a reason for hiding this comment

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

The use of 'key?' in the params list is non-standard YAML. If you intend to indicate that 'key' is optional, consider documenting this in a comment or in the documentation body, rather than using a question mark in the key name.

@github-actions
Copy link
Contributor

github-actions bot commented Jun 4, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/connections/connect-devices/ @kkrum, @kokolocomotion1, @ranbel, @cloudflare/pcx-technical-writing
/src/content/docs/cloudflare-one/identity/ @kennyj42, @ranbel, @cloudflare/pcx-technical-writing
* @cloudflare/pcx-technical-writing

@deadlypants1973 deadlypants1973 merged commit b35d798 into production Jun 4, 2025
12 checks passed
@deadlypants1973 deadlypants1973 deleted the kate/fixes-frontmattercert branch June 4, 2025 16:52
sdnts pushed a commit to sdnts/cloudflare-docs that referenced this pull request Jul 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants