> ## Documentation Index
> Fetch the complete documentation index at: https://portfolio.subinb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Content design review: Delete table dialog

> Delete Table modal: rewritten per Atlassian content design guidelines.

<CardGroup cols={2}>
  <Card title="Before: Original dialog">
    <Frame>
      <img src="https://mintcdn.com/na-329bd696/vi34k3uG0u6WKyBG/images/content-design/delete-table-before.png?fit=max&auto=format&n=vi34k3uG0u6WKyBG&q=85&s=e4af547b9c36e1c1aeb1d0c36c4332de" alt="Original Delete Table dialog" width="1120" height="580" data-path="images/content-design/delete-table-before.png" />
    </Frame>
  </Card>

  <Card title="After: Revised dialog">
    <Frame>
      <img src="https://mintcdn.com/na-329bd696/vi34k3uG0u6WKyBG/images/content-design/delete-table-after.png?fit=max&auto=format&n=vi34k3uG0u6WKyBG&q=85&s=4ac5d7aead8cc7b3088d2e8b0df4dd32" alt="Revised Delete this table? dialog" width="1120" height="584" data-path="images/content-design/delete-table-after.png" />
    </Frame>
  </Card>
</CardGroup>

## Process

<Card title="AI-assisted workflow" icon="sparkles">
  This rewrite was generated using an AI-assisted workflow. I first prompted an AI model to evaluate the original copy against the **[Atlassian content design guidelines](https://atlassian.design/foundations/content)**, which served as the baseline standard for voice, tone, and terminology.

  After generating the initial critique and suggestions, I **manually reviewed and refined** the recommendations to ensure they were contextually accurate, clear, and perfectly aligned with the intended user experience before arriving at the final output.
</Card>

## What changed and why

<Steps>
  <Step title="Title: verb-led question, sentence case">
    "Delete Table" uses title case and reads as a noun phrase. "Delete this table?" leads with the verb and frames the dialog as a confirmation question, consistent with Atlassian's modal title pattern. "table" is lowercase because it refers to the object, not a proper name.
  </Step>

  <Step title="Body: state the consequence, not just the action">
    "Are you sure you want to remove this table?" states the action but gives no consequence. The revised copy explicitly names the result ("permanently delete… cannot be undone") and anchors it to a specific object via an inline chip, removing all ambiguity about what will be lost.
  </Step>

  <Step title="Warning: be specific about impact">
    "This table maybe used in some of the interfaces for a pivot or chart creation" is vague, contains a grammar error ("maybe" should be "may be"), and ends with the hedge "Please proceed with caution." Atlassian guidelines require warning messages to state the actual downstream impact. The revised message names it precisely: **2 charts and 1 pivot**.
  </Step>

  <Step title="Warning severity: use the correct color role">
    A yellow triangle signals a recoverable caution state. Deleting a table that breaks downstream views is irreversible, which is a danger-level action. Atlassian reserves red for situations involving data loss or broken functionality. The revised dialog uses the danger appearance for the inline message.
  </Step>

  <Step title="Button label: sentence case, mirrors dialog verb">
    "Delete Table" (title case) becomes "Delete table" (sentence case). Atlassian's writing guidelines require sentence case for all UI controls. The button copy also mirrors the title verb so the user sees consistent language from heading to action.
  </Step>

  <Step title="Remove 'please' and hedging language">
    "Please proceed with caution" adds no information and softens a message that should be direct. Atlassian voice is honest and clear. If something is at risk, name what is at risk; do not pad with polite disclaimers.
  </Step>
</Steps>

***

## Copy comparison

Atlassian content design guidelines applied.

| Element              | Before                                                                                                                        | After                                                                           | Guideline                                                                                                 |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Modal title**      | Delete Table                                                                                                                  | Delete this table?                                                              | Sentence case for all UI text. Verb-led question for destructive confirmations.                           |
| **Body copy**        | Are you sure you want to remove this table?                                                                                   | This will permanently delete \[table] and cannot be undone.                     | State the consequence. Name the object. Avoid "are you sure" as it adds friction without information.     |
| **Warning message**  | This table maybe used in some of the interfaces for a pivot or chart creation. Please proceed with caution. *(grammar error)* | This table is used in 2 charts and 1 pivot. Deleting it will break those views. | Be specific. Quantify impact. Fix grammar. Remove hedging. Use danger appearance for destructive actions. |
| **Warning type**     | Yellow ▲ caution                                                                                                              | Red ● danger                                                                    | Use danger color role for actions resulting in data loss or broken views.                                 |
| **Primary button**   | Delete Table                                                                                                                  | Delete table                                                                    | Sentence case for all controls. Button label mirrors dialog title verb.                                   |
| **Secondary button** | Cancel                                                                                                                        | Cancel (no change needed)                                                       | Already correct.                                                                                          |
