Skip to content

[No QA] Consolidated help docs: travel/booking-travel - #101945

Closed
stephanieelliott wants to merge 1 commit into
mainfrom
helpsite-consolidated-travel-booking-travel
Closed

stephanieelliott wants to merge 1 commit into
mainfrom
helpsite-consolidated-travel-booking-travel

Conversation

@stephanieelliott

Copy link
Copy Markdown
Contributor

Summary

Consolidates 1 help doc PRs for travel/booking-travel into a single reviewable PR.

Included PRs

Test plan

  • Review combined doc changes for accuracy and conflicts
  • Verify no duplicate or contradictory guidance within the folder
  • No QA

@melvin-bot

melvin-bot Bot commented Sep 23, 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 @johncschuster

@melvin-bot

melvin-bot Bot commented Sep 23, 2026

Copy link
Copy Markdown

@puneetlath @johncschuster One of you needs to 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 September 23, 2026 01:44

Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: This sentence is hard to scan — it repeats Book travel three times in one sentence and packs a search flow plus a conditional into a single line. Consider splitting into a short step and a separate conditional sentence, e.g. "Or select Search (the magnifying glass icon), type Book travel, then select the Book travel result." followed by a separate note that this option only appears when Expensify Travel is enabled on your active workspace.

Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: The sentence repeats Book travel three times and combines a search-based navigation flow with a conditional in one line, hurting scannability. Split the search flow and the availability condition into two shorter sentences.


Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: The sentence repeats Book travel three times and merges a search flow with an availability condition in one line, hurting scannability. Split the search-based navigation and the condition into two shorter sentences.


Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: The sentence repeats Book travel three times and combines a search flow with a conditional in one line, reducing scannability. Split the search-based navigation and the availability condition into two shorter sentences.

Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: The sentence repeats Book travel three times and merges a search flow with an availability condition in one line, hurting scannability. Split the search-based navigation and the condition into two shorter sentences.

Tap the **➕ Create** button at the bottom of your screen, then choose **Book travel**.

You can also select **Search** (the magnifying glass icon), type **Book travel**, then select the **Book travel** result. **Book travel** appears in both places only when Expensify Travel is enabled on your active workspace.

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: The sentence repeats Book travel three times and combines a search flow with a conditional in one line, reducing scannability. Split the search-based navigation and the availability condition into two shorter sentences.

@github-actions

Copy link
Copy Markdown
Contributor

HelpDot Documentation Review

Overall Assessment

This PR consolidates a single upstream change (PR 100223) and adds one identical sentence to six travel/booking-travel articles (Arrange Travel for Another User, Book Rail Travel, Book Travel for a Guest, Book a Flight, Book a Hotel, Book a Rental Car). The added content documents an alternative way to reach Book travel via Search, plus a conditional note about when it appears. The change is small, consistent, and additive.

Scores Summary

  • Readability: 8/10 - The new sentence is clear and action-oriented. The second sentence bundles a conditional (appears in both places only when...) that is slightly dense but understandable.
  • AI Readiness: 8/10 - No heading or metadata changes; added text lives under existing task-based headings and uses full feature names (Expensify Travel, Book travel). Nothing in the diff regresses retrieval quality.
  • Style Compliance: 7/10 - UI labels Search and Book travel are correctly bolded per Button Naming Standards. Minor issues noted below.

Key Findings

  • Positive: The alternative-path guidance is genuinely useful and consistently worded across all six files, avoiding contradictory phrasing.
  • Positive: Action verbs (select, type, then select) follow the deterministic writing rule.
  • Style: "your active workspace" uses lowercase "workspace". Naming conventions treat Workspace as a defined product term (e.g., Workspace Admin); prefer consistent capitalization.
  • Style: "(the magnifying glass icon)" is a reasonable icon descriptor, but consider matching the exact UI label/tooltip for the Search control to satisfy the exact-UI-terminology rule.

Recommendations

  • Consider capitalizing "Workspace" in "your active workspace" for terminology consistency.
  • Optionally confirm the Search control's exact UI label so the icon reference matches the product exactly.
  • No structural, heading, or metadata concerns; the diff is safe to merge after the minor wording tweaks above.

Files Reviewed

  • Arrange-Travel-for-Another-User.md - Additive sentence, compliant
  • Book-Rail-Travel.md - Additive sentence, compliant
  • Book-Travel-for-a-Guest.md - Additive sentence, compliant
  • Book-a-Flight.md - Additive sentence, compliant
  • Book-a-Hotel.md - Additive sentence, compliant
  • Book-a-Rental-Car.md - Additive sentence, compliant

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: 65bf6f4afc

ℹ️ 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".

Comment thread Web-Expensify
@@ -0,0 +1 @@
Subproject commit 2a25b4883a6d80dc7f005605ecce914f2ada01d6

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Remove the unconfigured Web-Expensify gitlink

When a workflow checks out submodules—such as .github/workflows/deploy.yml at line 44 or .github/workflows/buildAndroid.yml at line 68—Git treats this new entry as a submodule, but .gitmodules defines only Mobile-Expensify, so initialization aborts with fatal: no submodule mapping found in .gitmodules for path 'Web-Expensify'. Remove this accidental gitlink, or add a valid mapping if it is intentional, so deploy and mobile-build jobs can complete checkout.

Useful? React with 👍 / 👎.

@stephanieelliott

Copy link
Copy Markdown
Contributor Author

Handling in the original PR

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.

1 participant