[No QA] Update Expensify Card article with name and phone number details#84364
[No QA] Update Expensify Card article with name and phone number details#84364
Conversation
Updates the Cardholder Settings article to: - Change title to "Update Your Expensify Card Details" - Add section on how to update the name on your Expensify Card via Legal Name under Account > Profile > Private - Add section on how to update the phone number linked to your Expensify Card for 3D Secure verification - Add FAQ entry for changing the embossed name on a physical card Co-authored-by: Stephanie Elliott <stephanieelliott@users.noreply.github.com>
HelpDot Documentation ReviewOverall AssessmentThis PR enhances the Cardholder Settings and Features article by adding two new procedural sections (updating the name and phone number on an Expensify Card) and a supporting FAQ entry. It also makes several housekeeping improvements: converting absolute URLs to relative paths, capitalizing section headings consistently, correcting product name capitalization ("Expensify Card" vs. "Expensify card"), and removing a stale link to an Expensify Classic article. The changes are well-structured and add genuinely useful content. A few areas could be tightened further. Scores Summary
Key FindingsPositive aspects
Items to address
Recommendations
Files Reviewed
Note: This review is based solely on the proposed diff, not on unchanged portions of the file. |
|
A preview of your ExpensifyHelp changes have been deployed to https://91147522.helpdot.pages.dev ⚡️ Updated articles: |
docs/articles/new-expensify/expensify-card/Cardholder-Settings-and-Features.md
Show resolved
Hide resolved
| title: Using Your Expensify Card in New Expensify | ||
| description: Learn how to activate, use, and manage your physical and virtual Expensify Card, including Smart Limits, notifications, and troubleshooting. | ||
| keywords: [New Expensify, Expensify Card, Smart Limit, activate card, virtual card, card notifications, card declined, eReceipts] | ||
| title: Update Your Expensify Card Details |
There was a problem hiding this comment.
AI Readiness violation -- title does not reflect article scope: The new title "Update Your Expensify Card Details" suggests the article is only about updating card details, but this article covers much more: activation, Smart Limits, notifications, managing expenses, virtual cards, digital wallets, and troubleshooting. A title that is too narrow will cause AI systems and search to miss relevant content. Consider a title that captures the full scope, such as:
| title: Update Your Expensify Card Details | |
| title: Expensify Cardholder Settings and Features |
Alternatively, if the intent is to narrow the article strictly to "updating details," the unrelated sections (Smart Limits, notifications, virtual cards, digital wallet, etc.) should be moved to separate articles.
|
|
||
| --- | ||
|
|
||
| # How to Update the Name on Your Expensify Card |
There was a problem hiding this comment.
Readability / Style consistency violation: The "How to" prefix is unnecessary filler. Other H1 headings in this same article use a direct imperative verb style ("Activate Your Expensify Card", "Enable Notifications", "Manage Your Card Expenses"). This heading should follow the same pattern for consistency and scannability.
| # How to Update the Name on Your Expensify Card | |
| # Update the Name on Your Expensify Card |
|
|
||
| --- | ||
|
|
||
| # How to Update the Phone Number Linked to Your Expensify Card |
There was a problem hiding this comment.
Readability / Style consistency violation: Same "How to" prefix issue as the previous heading. Use a direct imperative verb form to match the other headings in this article.
| # How to Update the Phone Number Linked to Your Expensify Card | |
| # Update the Phone Number Linked to Your Expensify Card |
|
|
||
| # How to Update the Name on Your Expensify Card | ||
|
|
||
| The name embossed on your physical Expensify Card is pulled from the legal name in your profile. To update the name associated with your Expensify Card, update your legal name in your profile settings. |
There was a problem hiding this comment.
Readability violation -- repetitive phrasing: This sentence repeats "legal name," "profile," and "update" in close succession, making it feel redundant. Consider tightening it:
| The name embossed on your physical Expensify Card is pulled from the legal name in your profile. To update the name associated with your Expensify Card, update your legal name in your profile settings. | |
| The name on your physical Expensify Card comes from the legal name in your profile. To change it, update your legal name by following these steps: |
| 2. Select **Profile**. | ||
| 3. Under **Private**, select **Legal name**. | ||
| 4. Update your **Legal first name** and **Legal last name**. | ||
| 5. Click **Save**. |
There was a problem hiding this comment.
Expensify Style violation -- button label: Per Expensify style guidelines, the final action in a flow should use "Confirm" rather than "Save." If the UI button actually reads "Save," disregard this comment -- but please verify the button label matches what is shown in the app.
| 5. Click **Save**. | |
| 5. Click **Confirm**. |
| 1. Choose **Account** in the navigation tabs (on the left on web, on the bottom on mobile). | ||
| 2. Select **Profile**. | ||
| 3. Under **Private**, select **Phone number**. | ||
| 4. Enter your updated phone number and click **Save**. |
There was a problem hiding this comment.
Expensify Style violation -- button label: Same as the name update section -- "Save" should be "Confirm" at the end of a flow, unless the UI literally displays "Save." Please verify the actual button text.
| 4. Enter your updated phone number and click **Save**. | |
| 4. Enter your updated phone number and click **Confirm**. |
| 4. Update your **Legal first name** and **Legal last name**. | ||
| 5. Click **Save**. | ||
|
|
||
| Your updated name will be associated with your Expensify Card. To receive a new physical card with the updated name, you will need to request a replacement card. See the FAQ below for details. |
There was a problem hiding this comment.
Readability violation -- verbose language: "you will need to request a replacement card" uses unnecessary filler ("you will need to"). Simplify for directness:
| Your updated name will be associated with your Expensify Card. To receive a new physical card with the updated name, you will need to request a replacement card. See the FAQ below for details. | |
| Your updated name will be associated with your Expensify Card. To get a new physical card with the updated name, request a replacement card. See the FAQ below for details. |
|
|
||
| If your physical card hasn't arrived within a week, confirm your mailing address is correct and request a new card. See [this guide](https://help.expensify.com/articles/expensify-classic/expensify-card/Request-the-Expensify-Card#steps-to-request-the-expensify-card) for requesting a new Expensify Card. | ||
| 1. Update your legal name in your profile by going to **Account > Profile > Private > Legal name**. | ||
| 2. Then request a replacement card by going to **Account > Wallet**, selecting your physical card, and clicking **Report card lost or damaged**. |
There was a problem hiding this comment.
Readability violation -- redundant "Then" in numbered step: Numbered steps already convey sequence, so starting with "Then" is unnecessary filler. Remove it for cleaner instructions:
| 2. Then request a replacement card by going to **Account > Wallet**, selecting your physical card, and clicking **Report card lost or damaged**. | |
| 2. Request a replacement card by going to **Account > Wallet**, selecting your physical card, and clicking **Report card lost or damaged**. |
…-and-Features.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
|
Closing this PR — it modified the wrong article. A new PR will be opened targeting the correct file. |
Summary
$ https://github.com/Expensify/Expensify/issues/590265
Test plan