Skip to content

Conversation

@caley-b
Copy link
Contributor

@caley-b caley-b commented Nov 10, 2025

Summary

Adding a new section to the How we Docs section of the style guide, called How we AI.

Screenshots (optional)

Documentation checklist

@github-actions
Copy link
Contributor

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

Pattern Owners
/src/content/docs/style-guide/ @dcpena, @cloudflare/pcx-technical-writing

@github-actions
Copy link
Contributor

github-actions bot commented Nov 10, 2025

Preview URL: https://8c5991f8.preview.developers.cloudflare.com
Preview Branch URL: https://how-we-ai-style-guide.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/prompt-templates/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/prompt-templates/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/when-we-use-ai/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/when-we-use-ai/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/clue/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/clue/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/prompt-libraries/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/prompt-libraries/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/examples/
https://developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/ https://how-we-ai-style-guide.preview.developers.cloudflare.com/style-guide/how-we-docs/how-we-ai/

caley-b and others added 10 commits November 11, 2025 07:38
…oudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…oudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…oudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…oudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…oudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…dex.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
…aries.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
caley-b and others added 24 commits November 11, 2025 07:47
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…ue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…dex.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…dex.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…aries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…aries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…aries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…aries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…lates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
…-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
@caley-b caley-b merged commit 9c881f7 into production Nov 12, 2025
8 checks passed
@caley-b caley-b deleted the how-we-ai-style-guide branch November 12, 2025 20:09
threepointone pushed a commit that referenced this pull request Nov 13, 2025
* First round of "how we AI" topics to get the ball rolling.

* fixed spacing issue in the frontmatter.

* Fixed titles and made some of the headings smaller.

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/index.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/cloudspeaker.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/clue.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/index.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/examples/index.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-libraries.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/prompt-templates.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Update src/content/docs/style-guide/how-we-docs/how-we-ai/when-we-use-ai.mdx

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>

* Integrated Alexa's feedback.

---------

Co-authored-by: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com>
Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
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.

5 participants