Skip to content

Conversation

@OliviaShoup
Copy link
Contributor

What does this PR do? What is the motivation?

This PR adds a new page for the new Actions & Remediations feature Forms.

Merge instructions

Merge readiness:

  • Ready for merge

@OliviaShoup OliviaShoup requested a review from a team as a code owner November 13, 2025 18:17
@OliviaShoup OliviaShoup added the Do Not Merge Just do not merge this PR :) label Nov 13, 2025
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label Nov 13, 2025
@github-actions
Copy link
Contributor

Preview links (active after the build_preview check completes)

New or renamed files

Copy link
Contributor

@urseberry urseberry left a comment

Choose a reason for hiding this comment

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

👋 This doc contains all of the information from the demo, and organizes it in a logical order. 💟 I left a few suggestions.

1. Click **Responses**.
1. Click the edit icon on a response to view the JSON version.

**Note**: Responses to forms generate a datastore, which are listed in [Datastores][7].
Copy link
Contributor

Choose a reason for hiding this comment

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

This line makes it sound like the datastore is generated when someone responds. I tested this, and the datastore is created when you save the form, not when someone submits the first response.

You can avoid the issue of timing entirely by saying that Datadog stores the responses in a datastore.


## Overview

Datadog Forms allows you to collect input, analyze responses, and trigger automations in Datadog. Forms and their responses can be shared across your organization, allowing you to collect and analyze data with your team. Because you don't need a Datadog account to respond to forms, they can also be shared with customers, internal teams, and other stakeholders.

Choose a reason for hiding this comment

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

"Because you don't need a Datadog account to respond to forms, they can also be shared with customers, internal teams, and other stakeholders. "
this is not correct (yet). Public forms will be available only in Q1 so currently they need a datadog account for creating / sharing forms

Choose a reason for hiding this comment

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

Not just a datadog account, they're only available within the same org

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thank y'all. i just cut that sentence altogether but happy to write something else if we need it


To create a new form:
1. Navigate to the [Forms][1] page.
1. Click **+ New Form**.

Choose a reason for hiding this comment

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

We have a few blueprints (as of today) so worth mentioning that path as well

Copy link
Contributor Author

Choose a reason for hiding this comment

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

thank you! are they in Forms or somewhere else? i'm not seeing them yet

disable_toc: false
---

{{< callout url="LINK GOES HERE" btn_hidden="false" header="Join the Preview!" >}}

Choose a reason for hiding this comment

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

@github-actions github-actions bot added the Images Images are added/removed with this PR label Nov 19, 2025
Here are some ways you can use forms:
- Scaffold services with a [scaffolding blueprint][3].
- Collect engineering feedback in an internal developer portal (IDP).
- Create security cases directly from employee form responses.

Choose a reason for hiding this comment

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

Can we not focus on security and Instead, we should focus on generic service requests for security, platform or IT teams

1. Select the datastore associated with your form, then click **Insert into editor**.
1. Optionally, click the query's title to rename it.
1. Click **Save**.
1. [Create a dashboard][9], then add a [Query Value widget][14].

Choose a reason for hiding this comment

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

It doesn't need to be query value widget, we support any any widget other than the Timeseries




### Start with a blueprint

Choose a reason for hiding this comment

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

Why do we have all of that again? it sounds repetitive, you mention above that users can start from scratch or blueprint, I don't think we should repeat all of that again here.

Copy link
Contributor Author

@OliviaShoup OliviaShoup Nov 19, 2025

Choose a reason for hiding this comment

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

thank you for catching that! i'd actually been drafting down there and forgot to cut it

## Examples

Here are some ways you can use forms:
- Scaffold services with a [scaffolding blueprint][3].

Choose a reason for hiding this comment

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

I'm not sure about this specific blueprint. let me double check

Choose a reason for hiding this comment

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

Just change the sentence to this one and remove the link:
"Scaffold services from predefined templates"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend Do Not Merge Just do not merge this PR :) Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants