Skip to content

[No QA] Docs updates for E/A#95496 Getting started for personal spending intent - #96540

Merged
brianlee-expensify merged 3 commits into
mainfrom
claude-docs-gettingStartedPersonal
Aug 4, 2026
Merged

brianlee-expensify merged 3 commits into
mainfrom
claude-docs-gettingStartedPersonal

Conversation

@MelvinBot

Copy link
Copy Markdown
Contributor

Explanation of Change

Follow-up help site update for #95496, which adds a Getting started checklist to Home for the Organize my personal spending onboarding intent.

The existing Expensify Home Overview article documented the Getting started section only for the manage my team and track and budget my expenses intents. This PR updates docs/articles/new-expensify/getting-started/Expensify-Home-Overview.md to reflect the new behavior:

  • Adds Organize my personal spending to the list of intents that surface the Getting started section.
  • Documents its checklist to-dos verified against the live UI labels: Create a workspace, Customize spend categories, Create an expense, and Link personal card.
  • Notes that Customize spend categories only appears while the Categories feature is enabled, and that the section disappears once all tasks are complete.
  • Updates the FAQ so the visibility conditions match the new behavior (the section now shows a single Create a workspace step instead of hiding when there is no active paid workspace).
  • Adds related search keywords for retrieval.

Fixed Issues

Related to #95496 and #93108

Tests / QA

Documentation-only change. Verify the rendered article at the Expensify Home Overview page reflects the current behavior described above.


@adamgrzybowski, please review the files changed and confirm they reflect the current behavior. Then mark this PR Ready for review.

…pending intent

Co-authored-by: Adam Grzybowski  <adamgrzybowski@users.noreply.github.com>
@MelvinBot MelvinBot added the HelpDot Apply this label if the issue relates to ExpensifyHelp label Jul 21, 2026
@github-actions github-actions Bot changed the title Docs updates for E/A#95496 Getting started for personal spending intent [No QA] Docs updates for E/A#95496 Getting started for personal spending intent Jul 21, 2026
@OSBotify

This comment has been minimized.

@stephanieelliott
stephanieelliott marked this pull request as ready for review July 25, 2026 03:16
@stephanieelliott
stephanieelliott self-requested a review as a code owner July 25, 2026 03:16
@OSBotify

This comment has been minimized.

@github-actions

Copy link
Copy Markdown
Contributor

HelpDot Documentation Review

Overall Assessment

This PR makes targeted edits to a single article, Expensify-Home-Overview.md, to reflect the new Organize my personal spending onboarding intent. Changes include expanded keywords, trimmed detail in the Recently added and Getting started sections, and an updated FAQ answer. The changes are consistent with the article existing style and improve alignment with current product behavior, but a few edits reduce useful detail and introduce minor casing inconsistencies.

Scores Summary

  • Readability: 8/10 - Edited sentences are clear and scannable. However, removing the how-it-works detail from the Recently added section (row contents, sorting, empty state) and the checklist-item detail from Getting started makes those sections thinner and slightly less helpful.
  • AI Readiness: 8/10 - Keywords were meaningfully expanded to match real personal-spending search queries, and internalScope is present. Task-based How the ... works on Home headings are preserved. The edits reduce some retrievable specifics (the free-trial / 60-day / intent conditions are now less explicit in the body).
  • Style Compliance: 6/10 - Bolded feature names and the three dots reference are correct. Main issue: casing inconsistency in the FAQ. The added intent is written Organize my personal spending (title case) while the sibling intents in the same sentence use lowercase (manage my team, track and budget my expenses). Per the exact-UI-text rule, these must match the product UI and each other.

Key Findings

  • Casing inconsistency: Organize my personal spending vs. manage my team / track and budget my expenses in the same FAQ sentence. Align to the exact UI label.
  • The FAQ answer and the body section now describe the appearance conditions differently. The FAQ still cites within 60 days of your free trial start date, while the body was simplified to you own a workspace on a free trial or have setup tasks to complete. These two descriptions should be reconciled so guidance is consistent.
  • Positive: keyword expansion is well targeted to personal-spending search intent and strengthens retrieval.
  • Content loss: the Recently added removal drops genuinely useful specifics (up-to-five limit, sort order, row fields, empty state) that helped users understand the section.

Recommendations

  • Fix the intent casing so all three intents match the exact UI text and each other.
  • Reconcile the body vs. FAQ descriptions of when the Getting started section appears (free trial, intent, and any 60-day window) so they tell one consistent story.
  • Consider retaining a brief version of the removed Recently added detail (limit, sort order, empty state) if it still reflects current behavior.

Files Reviewed

  • docs/articles/new-expensify/getting-started/Expensify-Home-Overview.md - Approve with minor changes; fix intent casing and reconcile the Getting started appearance conditions.

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

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8478b6148c

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@OSBotify

Copy link
Copy Markdown
Contributor

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

Updated articles:

@stephanieelliott
stephanieelliott requested a review from a team August 1, 2026 02:07
@melvin-bot

melvin-bot Bot commented Aug 1, 2026

Copy link
Copy Markdown

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 @brianlee-expensify

@melvin-bot
melvin-bot Bot requested a review from brianlee-expensify August 1, 2026 02:07
@melvin-bot

melvin-bot Bot commented Aug 1, 2026

Copy link
Copy Markdown

@brianlee-expensify 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 August 1, 2026 02:08
@brianlee-expensify
brianlee-expensify merged commit fcc9cf2 into main Aug 4, 2026
15 checks passed
@brianlee-expensify
brianlee-expensify deleted the claude-docs-gettingStartedPersonal branch August 4, 2026 14:56
@brianlee-expensify

Copy link
Copy Markdown
Contributor

@stephanieelliott merged!

@OSBotify OSBotify mentioned this pull request Aug 4, 2026
52 tasks done
@OSBotify

OSBotify commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

🚀 Deployed to staging by https://github.com/brianlee-expensify in version: 9.4.50-0 🚀

platform result
🕸 web 🕸 success ✅
🤖 android 🤖 success ✅
🍎 iOS 🍎 success ✅

@OSBotify

OSBotify commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

🚀 Deployed to production by https://github.com/arosiclair in version: 9.4.50-3 🚀

platform result
🕸 web 🕸 success ✅
🤖 android 🤖 success ✅
🍎 iOS 🍎 success ✅

Bundle Size Analysis (Sentry):

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

Labels

HelpDot Apply this label if the issue relates to ExpensifyHelp

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants