Skip to content

[No QA] Update help docs for Release 3 multi-workspace card feed sharing#86930

Open
MelvinBot wants to merge 4 commits intomainfrom
claude-release3HelpSiteCardFeedSharing
Open

[No QA] Update help docs for Release 3 multi-workspace card feed sharing#86930
MelvinBot wants to merge 4 commits intomainfrom
claude-release3HelpSiteCardFeedSharing

Conversation

@MelvinBot
Copy link
Copy Markdown
Contributor

Explanation of Change

Updates help site documentation for Release 3 of the Universal Feed project (multi-workspace card feed sharing). With Release 3, admins can now link a single card feed to multiple workspaces using the same settlement account, rather than needing separate feeds and bank accounts per workspace.

Changes:

  • Set-Up-and-Manage-the-Expensify-Card.md:

    • Added a note in Step 2 explaining that admins can select an existing Expensify Card feed from another workspace instead of connecting a new bank account
    • Updated the FAQ answer for "Can I use Expensify Cards across multiple workspaces?" to reflect that workspaces can now share a single feed and settlement account (previously stated each workspace needed its own settlement account)
  • Company-Card-Settings.md:

    • Updated the "Remove the card connection" description to reflect new unlinking behavior: removing a feed from a workspace now unlinks it and removes that workspace's members, rather than deleting the entire feed — unless it is the last linked workspace

Fixed Issues

$ https://github.com/Expensify/Expensify/issues/590511

Tests

  • Verified markdown renders correctly
  • No new UI elements introduced — changes are documentation-only
  • Confirmed all UI labels match existing article conventions

Web QA

Documentation-only change. QA should verify the updated articles render correctly on the help site.

Mobile QA

No mobile QA — documentation-only change.

- Update Expensify Card setup guide to explain selecting an existing feed
- Update FAQ to reflect shared settlement account across workspaces
- Update Company Card Settings to describe unlink vs full delete behavior

Co-authored-by: Stephanie Elliott <stephanieelliott@users.noreply.github.com>
@MelvinBot MelvinBot requested a review from a team April 2, 2026 04:03
@github-actions github-actions bot changed the title Update help docs for Release 3 multi-workspace card feed sharing [No QA] Update help docs for Release 3 multi-workspace card feed sharing Apr 2, 2026
@OSBotify
Copy link
Copy Markdown
Contributor

OSBotify commented Apr 2, 2026

@MelvinBot
Copy link
Copy Markdown
Contributor Author

Fixed the failing spellcheck: typo workspceworkspace in Company-Card-Settings.md (line 5). Also corrected the frontmatter key from internalSCopeinternalScope.

@stephanieelliott stephanieelliott marked this pull request as ready for review April 2, 2026 04:47
@melvin-bot
Copy link
Copy Markdown

melvin-bot bot commented Apr 2, 2026

Concierge reviewer checklist:

  • I have verified the accuracy of the article
    • The article is within a hub that makes sense, and the navigation is correct
    • All processes, screenshots, and examples align with current product behavior.
    • All links within the doc have been verified for correct destination and functionality.
  • I have verified the readability of the article
    • The article's language is clear, concise, and free of jargon.
    • The grammar, spelling, and punctuation are correct.
    • The article contains at least one image, or that an image is not necessary
  • I have verified the formatting of the article
    • The article has consistent formatting (headings, bullet points, etc.) with other HelpDot articles and that aligns with the HelpDot formatting standards.
    • The article has proper text spacing and breaks for readability.
  • I have verified the article has the appropriate tone and style
    • The article's tone is professional, friendly, and suitable for the target audience.
    • The article's tone, terminology, and voice are consistent throughout.
  • I have verified the overall quality of the article
    • The article is not missing any information, nor does it contain redundant information.
    • The article fully addresses user needs.
  • I have verified that all requested improvements have been addressed

For more detailed instructions on completing this checklist, see How do I review a HelpDot PR as a Concierge Team member?

cc @NicMendonca

@melvin-bot melvin-bot bot requested a review from NicMendonca April 2, 2026 04:47
@melvin-bot
Copy link
Copy Markdown

melvin-bot bot commented Apr 2, 2026

@NicMendonca Please copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button]

@melvin-bot melvin-bot bot removed the request for review from a team April 2, 2026 04:47
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 2, 2026

HelpDot Documentation Review

Overall Assessment

This PR updates two help articles to support Release 3 of the Universal Feed project (multi-workspace card feed sharing). The changes are well-scoped and structurally sound. The most significant work is in Company-Card-Settings.md, which receives a heading restructure, new YAML metadata, and clearer content formatting. Set-Up-and-Manage-the-Expensify-Card.md receives targeted additions to describe the new multi-workspace feed sharing behavior. Both sets of changes bring the articles closer to governance compliance.

Scores Summary

  • Readability: 9/10 - The restructured settings section in Company-Card-Settings.md (changing from a terse bulleted list to a formatted description list with bold option names and explanatory text) is a clear improvement in scannability. The new paragraph in Set-Up-and-Manage-the-Expensify-Card.md explaining feed sharing is concise and well-placed. One minor note: the "Remove card feed" bullet has a **Note:** that is not indented to match the description block, which slightly disrupts the visual flow of the formatted list.
  • AI Readiness: 9/10 - Both files now include internalScope in their YAML frontmatter, completing the required metadata set (title, description, keywords, internalScope). The Company-Card-Settings.md diff correctly adds the # Company Card Settings title heading, demotes former # headings to ##, and adds "How to" prefixes to multiple headings. The article now includes several "How to" headings, improving semantic retrieval. The Set-Up-and-Manage-the-Expensify-Card.md changes are limited to metadata and content additions, which are appropriate.
  • Style Compliance: 9/10 - UI elements are bolded correctly throughout the diff (Settings, Workspaces, Card feed name, Allow deleting transactions, Remove card feed, Unreported, Draft, QuickBooks, NetSuite, Xero, etc.). Navigation paths follow the established pattern. The terminology updates ("Remove card feed" replacing "Remove the card connection") align with the new multi-workspace behavior. One minor observation: the navigation in the diff uses Go to **Settings > Workspaces > [Workspace Name] > Company Cards** while a later unchanged step uses Go to **Workspaces > [Workspace Name] > ... without the leading Settings > -- this inconsistency is not introduced by the diff but is worth noting for a future pass.

Key Findings

Positive aspects:

  • Adding internalScope to both articles completes the mandatory YAML metadata, which is a high-priority governance requirement.
  • The heading restructure in Company-Card-Settings.md resolves multiple governance violations: the article now has exactly one # title heading plus # FAQ, with all content sections at ## level.
  • Adding "How to" prefixes to export and eReceipt headings satisfies the requirement for at least one task-based "How to" heading and improves AI retrieval.
  • The restructured settings section (from terse bullets to a description list format) significantly improves readability and makes each setting self-explanatory.
  • The "Remove card feed" description accurately captures the new conditional deletion behavior for Release 3.
  • The FAQ answer update in Set-Up-and-Manage-the-Expensify-Card.md correctly replaces outdated information (separate bank accounts per workspace) with the new shared-feed model.

Items to consider (not blocking):

  • In Company-Card-Settings.md, the **Note:** lines under "Allow deleting transactions" and "Remove card feed" are left-aligned rather than indented under their parent bullet. This may render correctly in Jekyll but could look inconsistent depending on the Markdown renderer. Consider indenting them with two spaces to visually nest them under their parent items.
  • The new paragraph added in Set-Up-and-Manage-the-Expensify-Card.md Step 2 sits outside the numbered list, which is good for readability. However, it describes a conditional workflow ("If you already have an Expensify Card feed on another workspace...") that could benefit from being slightly more prominent -- for example, preceded by a visual separator or placed under a brief bold label like Tip: to help admins who are scanning quickly.

Recommendations

  1. Minor formatting polish (Company-Card-Settings.md): Consider indenting the **Note:** lines under the description list items so they render as part of the same block, rather than appearing as separate paragraphs.
  2. Future pass (not this PR): The Set-Up-and-Manage-the-Expensify-Card.md file still has pre-existing governance issues (multiple # headings like # Step 1, # Step 2, # Step 3, and # Monitor and Manage Cards) that were not introduced by this PR but should be addressed in a follow-up to match the heading standards applied to Company-Card-Settings.md.
  3. Navigation consistency (future pass): Standardize whether navigation paths include the leading Settings > prefix across all steps in Company-Card-Settings.md.

Files Reviewed

  • docs/articles/new-expensify/connect-credit-cards/Company-Card-Settings.md (22 additions, 12 deletions) -- Heading restructure, YAML metadata addition, content reformatting, and Release 3 behavioral updates. Well-executed changes that bring the article into governance compliance.
  • docs/articles/new-expensify/expensify-card/Set-Up-and-Manage-the-Expensify-Card.md (4 additions, 1 deletion) -- YAML metadata addition, new multi-workspace feed sharing paragraph, and FAQ answer update. Targeted, accurate changes.

Note: This review assesses only the proposed changes in the diff, not pre-existing content.

**Available actions include:**
- **Allow deleting transactions**
Enable this setting to allow cardholders to delete card transactions.
**Note:** This setting only applies to transactions imported after the setting is enabled.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Readability / structure: The **Note:** line is at the root indentation level (column 0), which breaks it out of the parent list item (- **Allow deleting transactions**) in Markdown rendering. It should be indented (e.g., with 2 or 4 spaces) so it remains visually and structurally part of that bullet point.

Suggested change
**Note:** This setting only applies to transactions imported after the setting is enabled.
**Note:** This setting only applies to transactions imported after the setting is enabled.

- **Remove the card connection:** Unassigns all cards and deletes unsubmitted expenses in draft reports
- **Remove card feed**
Remove the card feed from the workspace and unassign all cards. If the feed is not connected to another workspace, it is permanently deleted.
**Note:** Removing the feed or unassigning a card deletes all imported expenses in the **Unreported** and **Draft** states.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Readability / structure: Same issue as above -- the **Note:** line is at column 0, breaking out of the parent list item (- **Remove card feed**). Indent it to keep it under the bullet point.

Suggested change
**Note:** Removing the feed or unassigning a card deletes all imported expenses in the **Unreported** and **Draft** states.
**Note:** Removing the feed or unassigning a card deletes all imported expenses in the **Unreported** and **Draft** states.

title: Set Up and Manage Expensify Cards
description: Learn how Workspace Admins can enable, issue, and manage Expensify Cards for employees, including spending limits, bank connections, and virtual card setup.
keywords: [New Expensify, Expensify Card setup, manage virtual card, card limits, Expensify Visa, card settings, Workspace Admin]
internalScope: Applies to Workspace Admin. Covers Expensify Card setup and management. Does not cover troubleshooting or third-party feeds.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Naming and style: "Workspace Admin" (singular) is inconsistent with the article body (line 8: "Workspace Admins") and the other file in this PR (Company-Card-Settings.md uses "Workspace Admins"). Use the plural form for consistency. Also, there is a trailing whitespace character at the end of this line.

Suggested change
internalScope: Applies to Workspace Admin. Covers Expensify Card setup and management. Does not cover troubleshooting or third-party feeds.
internalScope: Applies to Workspace Admins. Covers Expensify Card setup and management. Does not cover troubleshooting or third-party feeds.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants