[No QA] Update business bank account help articles

[MelvinBot]

@garrettmknight lot of updates were made on this PR - some were required for this project, some were to de-duplicate content and tighten article scopes, fix outdated instructions, or optimize for AI.

I had Melvin generate a summary that maps the changes in this PR against the project's scoped requirements here, which will hopefully make review a little easier!

---

Summary

Updates all 5 business bank account help articles to comply with HelpDot authoring guidelines (HELPSITE_NAMING_CONVENTIONS.md, HELP_AUTHORING_GUIDELINES.md, TEMPLATE.md) and adds new content for Phases 3-5 of the business bank account conversion project.

Articles updated:

• Connect a Business Bank Account — Replaced "Step N:" headings with task-based headings, added Wallet entry point (Phase 4), linking existing accounts (Phase 3), and Wallet display changes (Phase 5)
• Validate a Business Bank Account — Restructured to single title, task-based headings, added Wallet navigation
• Unlock a Business Bank Account — Restructured headings, flattened ACH info sections, added Wallet/Workflows visibility for locked badges
• Share a Business Bank Account — Fixed three dots menu formatting, added relative cross-links, task-based headings
• Unshare a Business Bank Account — Fixed three dots menu formatting, task-based headings, consistent navigation

Key formatting changes across all articles:

• Exactly one # heading (article title) + optional # FAQ
• All ## headings start with a question word (How, What, Where, Who, Why, When)
• Added internalScope to all metadata blocks
• Three dots menu: the three dots **(⋮)** (per naming conventions)
• Cross-links use relative paths
• Screenshot placeholders use HTML comments
• Consistent web and mobile navigation instructions

Related to: https://github.com/Expensify/Expensify/issues/530547

Co-authored-by: stephanieelliott [email protected]

Test plan

• Verify articles render correctly on the help site (Jekyll build)
• Confirm all relative cross-links resolve correctly
• Review existing screenshots still display properly
• Verify metadata (title, description, keywords, internalScope) is correct for each article
• Sense-check content accuracy against current UI

[OSBotify]

A preview of your ExpensifyHelp changes have been deployed to https://a6d9a09c.helpdot.pages.dev ⚡️

Updated articles:

• articles/new-expensify/wallet-and-payments/Connect-a-Business-Bank-Account
• articles/new-expensify/wallet-and-payments/Share-a-Business-Bank-Account
• articles/new-expensify/wallet-and-payments/Unlock-a-Business-Bank-Account
• articles/new-expensify/wallet-and-payments/Unshare-a-Business-Bank-Account
• articles/new-expensify/wallet-and-payments/Validate-a-Business-Bank-Account

[MelvinBot]

Fixed the failing spellcheck: two typos in Connect-a-Business-Bank-Account.md — screendhots → screenshots (line 39) and accoun → account (line 65).

[MelvinBot]

Fixed the failing spellcheck: corrected two typos in Connect-a-Business-Bank-Account.md — Workdpace → Workspace (line 10) and phyical → physical (line 20).

[github-actions]

HelpDot Documentation Review

Overall Assessment

This PR rewrites five business bank account articles (Connect, Share, Unshare, Unlock, Validate) to align with current HelpDot governance standards. The changes are substantial and move these articles significantly closer to compliance: legacy <div id="new-expensify"> wrappers are removed, YAML frontmatter now includes internalScope, headings are converted to task-based ## format, navigation instructions follow the unified pattern, and three-dots menu references are corrected. The overall quality is high with a few items to address.

Scores Summary

• Readability: 9/10 - Steps are clear, sequential, and action-oriented. Sentences are concise and scannable. Minor formatting inconsistency in one file (missing period on step 6 in Unshare).
• AI Readiness: 9/10 - All five articles now have internalScope, task-based headings with feature names, and proper heading hierarchy (single # title plus ## sections plus # FAQ). Every article includes at least one "How to" heading. Keywords are realistic search phrases.
• Style Compliance: 8/10 - Three-dots menu references are correctly formatted in Share and Unshare articles. Navigation instructions use the unified pattern consistently. A few items noted below need attention.

Key Findings

Positive aspects:

• Excellent addition of internalScope to all five articles, with clear audience, covered workflows, and explicit exclusions.
• Consistent use of the unified navigation pattern: "In the navigation tabs (on the left on web, on the bottom on mobile)".
• Good cross-linking with descriptive anchor text (e.g., "learn how to share a business bank account") placed outside of numbered steps.
• FAQ headings are properly task-based or question-based throughout.
• Removal of legacy <div> wrappers and cleanup of excessive bold formatting improves readability.

Items to address:

1. Connect article -- heading without action verb or question word: The heading ## How business bank accounts appear in Wallet is borderline. Per governance, all ## headings must start with an action verb or question word. "How" is acceptable as a question word, so this passes, but consider whether "Where to find business bank accounts in Wallet" would better match a user's search intent.

2. Unshare article -- broken horizontal rule: Line -- (should be ---) will not render as a horizontal rule in Markdown. This appears between the "What happens after" section and the screenshots.

3. Unshare article -- missing period on step 6: Step 6 reads 6. Click **Confirm** without a trailing period, while all other steps end with periods. Minor but inconsistent.

4. Connect article -- external full URL: The link to census.gov/naics uses a full external URL (https://www.census.gov/naics/...). Per cross-linking standards, full URLs should be avoided for internal links -- but this is an external government site, so it is acceptable. Just flagging for awareness.

5. Connect article -- link inside numbered step: In the "How to add a new US business bank account in Wallet" section, step 6 says "Complete the identity verification, company details, and Beneficial Owner steps described below." This is fine. However, in the "What to expect after submitting" section, item 3 includes an inline link: "Learn how to validate a business bank account." Per governance, links should not be placed inside numbered step instructions. Consider moving this link after the numbered list.

6. Validate article -- heading style: ## When can a business bank account be validated does not start with a standard action verb or question word from the governance list. "When" is listed as acceptable, so this passes technically, but the content under it is more procedural context than a direct answer to "when." Consider rephrasing to something like ## What happens before you can validate a business bank account.

Recommendations

1. Fix the broken -- horizontal rule in the Unshare article (change to ---).
2. Move the inline link in the Connect article's numbered "What to expect" list to after the list, per cross-linking standards.
3. Add trailing period to step 6 in the Unshare article for consistency.
4. Review whether the "When can a business bank account be validated" heading in the Validate article could be rephrased for stronger task-based clarity.

Files Reviewed

• docs/articles/new-expensify/wallet-and-payments/Connect-a-Business-Bank-Account.md - Major rewrite. Well-structured with proper metadata, task-based headings, and clear steps. Minor link placement issue in numbered list.
• docs/articles/new-expensify/wallet-and-payments/Share-a-Business-Bank-Account.md - Good rewrite. Proper three-dots formatting, streamlined FAQ, correct cross-links.
• docs/articles/new-expensify/wallet-and-payments/Unlock-a-Business-Bank-Account.md - Solid rewrite. Clear unlock workflow, proper FAQ addition, correct heading structure.
• docs/articles/new-expensify/wallet-and-payments/Unshare-a-Business-Bank-Account.md - Good rewrite. Broken horizontal rule (-- instead of ---) needs fix. Missing period on one step.
• docs/articles/new-expensify/wallet-and-payments/Validate-a-Business-Bank-Account.md - Clean rewrite. Good troubleshooting section moved inline. One heading could be stronger.

Note: Detailed line-by-line feedback has been provided as inline comments.

[stephanieelliott]

@MelvinBot why did you leave comments, instead of in-line suggestions which can be committed?

[MelvinBot]

The review comments with formatting feedback (missing commas, broken horizontal rules, etc.) were posted by github-actions[bot] — a separate automated workflow that runs on HelpDot PRs — not by me directly. I don't control the output format of that workflow, so I can't make it use committable inline suggestions.

That said, I can fix all of those issues right now if you'd like — just reply with @MelvinBot fix the review comments and I'll push commits addressing them.

[stephanieelliott]

Addressed all bot comments!

[stephanieelliott]

@MelvinBot the changes in this PR extend beyond the scoped requirements outlined here.

To help reduce the review burden on the assigned project leads, can you provide a structured summary that maps each change in this PR to the corresponding project requirement?

Ideally, this should:
• Identify which changes are directly required vs. out of scope
• Link each required change to the relevant requirement
• Highlight exactly what reviewers should verify

The goal is to give reviewers a focused checklist, so they don’t need to review all 5 files end-to-end.

[MelvinBot]

PR Change Mapping to Project Requirements

Below maps every change in this PR against the scoped requirements (which references the Phase 1–6 design).

---

Legend

• Required — Directly implements a project phase
• Guideline — Applies HelpDot authoring guidelines (HELPSITE_NAMING_CONVENTIONS, HELP_AUTHORING_GUIDELINES, TEMPLATE)
• Out of scope — Not tied to any project requirement or guideline

---

1. Connect-a-Business-Bank-Account.md

Change	Category	Requirement	Verify
New section: "How to add a new US business bank account in Wallet"	Required	Phase 4 — Wallet entry point for business bank accounts	Navigation steps match expected Wallet flow
New section: "How to link an existing business bank account to a workspace"	Required	Phase 3 — Link existing account for reimbursements	Correctly describes linking (delegates to Share article)
New section: "How business bank accounts appear in Wallet" (separated sections, Action required badge)	Required	Phase 5 — Wallet display changes, partially set-up accounts	Accurately describes personal/business separation and badge
Title changed to "Connect a US Business Bank Account"	Out of scope	Narrows from multi-currency to US-only; the design doc doesn't call for dropping CAD/GBP/EUR/AUD coverage	Whether removing other currencies is intentional
Added internalScope metadata	Guideline	TEMPLATE.md requires internalScope	Content accuracy
Removed <div id="new-expensify"> wrapper	Guideline	Not in current template	—
"Step N:" headings → question-word ## headings	Guideline	HELP_AUTHORING_GUIDELINES: all ## start with question word	—
Rewording of FAQ headings to question-word format	Guideline	Same guideline	—
Removed McAfee reference from security FAQ	Out of scope	Not required by any phase	Whether removal is accurate
Navigation changed from workspace-first to Wallet-first	Required	Phase 4 — Wallet is now a primary entry point	—

2. Validate-a-Business-Bank-Account.md

Change	Category	Requirement	Verify
Navigation changed from workspace to Wallet ("click the bank account with the Pending badge")	Required	Phase 5 — Partially set-up accounts visible in Wallet	Steps match actual UI
Added internalScope	Guideline	TEMPLATE.md	Content accuracy
Restructured to single # title + question-word ## headings	Guideline	HELP_AUTHORING_GUIDELINES	—
New section: "Who can validate"	Out of scope	Not tied to any phase; new informational content	Accuracy
New section: "When can a business bank account be validated"	Out of scope	Restructures existing content into a new section	Accuracy
New FAQ: "What happens if I enter the wrong amounts?", "Can I skip validation if the account was shared with me?", "What if I don't have access?"	Out of scope	New FAQ content not in any requirement	Accuracy

3. Unlock-a-Business-Bank-Account.md

Change	Category	Requirement	Verify
Added Locked badge visibility in Wallet and Workflows	Required	Phase 6 — Show locked accounts in Wallet and workspace settings	Badge locations match UI
Navigation changed to Wallet-first unlock flow	Required	Phase 6 — Locked accounts visible in Wallet	Steps match actual UI
Added internalScope	Guideline	TEMPLATE.md	Content accuracy
Headings → question-word format	Guideline	HELP_AUTHORING_GUIDELINES	—
Flattened ACH info (removed code fences, inline formatting)	Guideline	Style consistency	ACH IDs unchanged
New FAQ section (3 new questions)	Out of scope	Not in any phase	Accuracy
Screenshot placeholder added	Guideline	Per article conventions	—

4. Share-a-Business-Bank-Account.md

Change	Category	Requirement	Verify
Navigation changed to "Account > Wallet"	Required	Phase 4/5 — Wallet is primary location	Steps match UI
Three dots formatting: three-dot menu (⋮) → three dots **(⋮)**	Guideline	HELPSITE_NAMING_CONVENTIONS	—
Added internalScope	Guideline	TEMPLATE.md	Content accuracy
Headings → question-word format	Guideline	HELP_AUTHORING_GUIDELINES	—
Relative cross-links (/articles/...) replacing absolute URLs	Guideline	Help site linking convention	Links resolve correctly
Removed "How business bank account sharing works when changing the payer" section	Out of scope	Removes existing content; no phase calls for this removal	Whether payer-change info should be preserved
Removed 2 FAQ questions about payer changes	Out of scope	Same as above	Same
Simplified sharing flow description (fewer steps)	Out of scope	Content simplification, not phase-required	Accuracy

5. Unshare-a-Business-Bank-Account.md

Change	Category	Requirement	Verify
Navigation changed to "Account > Wallet"	Required	Phase 4/5 — Wallet is primary location	Steps match UI
Three dots formatting fix	Guideline	HELPSITE_NAMING_CONVENTIONS	—
Added internalScope	Guideline	TEMPLATE.md	Content accuracy
Headings → question-word format	Guideline	HELP_AUTHORING_GUIDELINES	—
Changed eligibility from "Workspace Admin" to "Any member" who has validated copy	Out of scope	Not in any phase; changes access description	Whether this is accurate
Removed <div> wrapper	Guideline	Not in current template	—
Added "What happens after you unshare" section	Out of scope	Restructured from existing content	Accuracy
Simplified FAQ (merged/removed some questions)	Out of scope	Content cleanup	No important info lost

---

Reviewer Checklist

Phase 3 (Link existing bank account): Verify Connect-a-Business-Bank-Account.md "How to link an existing business bank account" section accurately describes the new linking flow.

Phase 4 (Wallet entry point): Verify all 5 articles now reference "Account > Wallet" navigation and that the new "How to add a new US business bank account in Wallet" section in Connect-a-Business-Bank-Account.md matches the actual UI flow (Make payments → country selector → existing setup flow).

Phase 5 (Partially set-up accounts): Verify Connect-a-Business-Bank-Account.md "How business bank accounts appear in Wallet" section accurately describes personal/business separation and Action required badges. Verify Validate-a-Business-Bank-Account.md correctly directs users to Wallet for pending accounts.

Phase 6 (Locked accounts): Verify Unlock-a-Business-Bank-Account.md accurately describes Locked badge visibility in both Wallet and Workflows.

Out-of-scope items requiring sign-off:

1. Title narrowed to "US Business Bank Account" — removes multi-currency coverage (CAD/GBP/EUR/AUD)
2. Removed payer-change documentation from Share article
3. Changed unshare eligibility from "Workspace Admin" to "Any member"
4. New FAQ content across Validate and Unlock articles
5. Removal of McAfee security reference