Skip to content

Conversation

@OliviaShoup
Copy link
Contributor

@OliviaShoup OliviaShoup commented Oct 6, 2025

What does this PR do? What is the motivation?

This PR adds the App Builder onboarding modal to our docs. This includes:

  • mentioning the onboarding modal on the App Builder landing page.
  • in Build Apps, describing the various ways to create an app from the onboarding modal.
  • linking to those new sections on the App Builder landing page.
  • updating some screenshots, adding their captions, and rewriting their alt text.

Merge instructions

This PR has already passed PM approval, so whoever approves from the docs team can merge it. Thank you!

Merge readiness:

  • Ready for merge

@OliviaShoup OliviaShoup self-assigned this Oct 6, 2025
@OliviaShoup OliviaShoup requested a review from a team as a code owner October 6, 2025 22:09
@OliviaShoup OliviaShoup added the under_review Sent to someone outside of the docs team for review. label Oct 6, 2025
@github-actions github-actions bot added the Images Images are added/removed with this PR label Oct 6, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Oct 6, 2025

Copy link
Contributor

@janine-c janine-c left a comment

Choose a reason for hiding this comment

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

Amazing!! Thanks so much for being so patient with all my feedback. I have a couple residual things here, but want to approve it so you aren't blocked. I think they should be fairly straightforward to address, but as always, let me know if you want to chat about anything or if there's anything else I can do to help you get it across the finish line!

To edit an app with JSON, click **Settings** {{< img src="icons/settings.png" inline="true" style="width:14px;">}} and select **Switch to JSON**. The **Switch to GUI** option in the settings menu takes you back to the GUI editor.
To edit an app with JSON, click **Settings** ({{< img src="icons/settings.png" inline="true" style="width:14px;">}}) and select **Switch to JSON**. The **Switch to GUI** option in the settings menu takes you back to the GUI editor.

### Export an app
Copy link
Contributor

Choose a reason for hiding this comment

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

I would call this "copy an app" or maybe "duplicate an app" to match the terminology you use underneath.


To iterate on an existing app:
1. From an existing app, click **Edit** then **Build with AI** (**<i class="icon-bits-ai"></i>**).
1. From [your apps list][14], hover over an app and click **Edit app** ({{< img src="icons/pencil.png" inline="true" style="width:14px;">}}).
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think I usually see icons in parentheses? I just did a search and it's very rare in the docs.

tag: "Learning Center"
text: "Getting Started with App Builder"
- link: "https://www.datadoghq.com/blog/generate-apps-with-ai/"
tag: "Blog"
Copy link
Contributor

Choose a reason for hiding this comment

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

Can you describe what the cursor is doing?

One time I was doing research on alt text and saw the recommendation that you should write it imagining that you're on the phone describing it to a friend. If we were on the phone and I saId "and then there's a picture of the app on a dashboard, and a cursor is clicking something," it would be totally understandable if you were like "what button??? what's it doing???!!!"

If it's not important, not describing it is definitely an option. Just think about what info you'd want to get across to someone if they couldn't see it 🙂

@OliviaShoup OliviaShoup merged commit f90dc0e into master Jan 5, 2026
17 checks passed
@OliviaShoup OliviaShoup deleted the olivia.shoup/docs-12177 branch January 5, 2026 23:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants