Skip to content

Delete placeholder pages leftover from the integration errors pages#85892

Open
stephanieelliott wants to merge 6 commits intomainfrom
helpsite-remove-placeholders
Open

Delete placeholder pages leftover from the integration errors pages#85892
stephanieelliott wants to merge 6 commits intomainfrom
helpsite-remove-placeholders

Conversation

@stephanieelliott
Copy link
Contributor

Deleting a bunch of placeholders left over from the integration errors project: https://github.com/Expensify/Expensify/issues/469226

@stephanieelliott stephanieelliott self-assigned this Mar 20, 2026
@stephanieelliott stephanieelliott requested a review from a team March 20, 2026 02:31
@melvin-bot
Copy link

melvin-bot bot commented Mar 20, 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 @CortneyOfstad

@melvin-bot melvin-bot bot requested review from CortneyOfstad and removed request for a team March 20, 2026 02:31
@melvin-bot
Copy link

melvin-bot bot commented Mar 20, 2026

@CortneyOfstad 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]

@github-actions
Copy link
Contributor

HelpDot Documentation Review

Overall Assessment

This is a focused cleanup PR that removes six identical placeholder pages left over from the integration errors project. Each deleted file contained only a stub with a forbidden "Overview" heading, a non-actionable description, and missing required YAML metadata fields. Removing these pages is the correct action -- they provided no value to users or AI retrieval systems and violated multiple governance rules.

Scores Summary

  • Readability: 10/10 - The proposed change (deletion of placeholder stubs) strictly improves readability across the help site. No under-construction dead ends remain for the affected directories.
  • AI Readiness: 10/10 - Removing pages that lacked keywords, internalScope, task-based headings, and any substantive content eliminates noise from the AI retrieval index.
  • Style Compliance: 10/10 - The deleted content violated HELP_AUTHORING_GUIDELINES.md Section 2 (forbidden "Overview" heading), Section 3 (missing keywords and internalScope metadata), Section 6 (no "How to" heading, no realistic search phrases), and TEMPLATE.md (incomplete YAML frontmatter). Deleting it resolves all violations with no new content to evaluate.

Key Findings

  • All six files were byte-identical placeholders with the text "This section is under construction. Content will be added in a follow-up PR."
  • The # Overview heading is explicitly listed as forbidden in HELP_AUTHORING_GUIDELINES.md Section 2.
  • The YAML frontmatter was missing both keywords and internalScope, which are required fields per HELP_AUTHORING_GUIDELINES.md Section 3 and TEMPLATE.md.
  • Each parent directory still contains other substantive articles (error-code-specific pages), so no empty directories will result from this deletion.

Recommendations

  • Approve as-is. This is a clean, beneficial removal of non-compliant placeholder content.
  • No further action is needed regarding empty directories -- all six parent folders retain other files after these deletions.

Files Reviewed

  • docs/articles/expensify-classic/connections/certinia/Troubleshooting/Export-Errors/Overview.md -- Deleted (placeholder)
  • docs/articles/expensify-classic/connections/quickbooks-online/Troubleshooting/Connection-errors/Overview.md -- Deleted (placeholder)
  • docs/articles/new-expensify/connections/quickbooks-online/Troubleshooting/Export-Errors/Overview.md -- Deleted (placeholder)
  • docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Authentication-and-Login-errors/Overview.md -- Deleted (placeholder)
  • docs/articles/new-expensify/connections/sage-intacct/Troubleshooting/Connection-errors/Overview.md -- Deleted (placeholder)
  • docs/articles/new-expensify/connections/xero/Troubleshooting/Connection-errors/Overview.md -- Deleted (placeholder)

No inline comments were added as there is no new or modified content to annotate -- all changes are deletions.

Copy link

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

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: 4a3a854e4c

ℹ️ 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 on lines -1 to -5
---
title: Overview
description: This section is under construction. Content will be added in a follow-up PR.
---

Choose a reason for hiding this comment

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

P2 Badge Add redirects for the deleted troubleshooting overview pages

Deleting this article without updating docs/redirects.csv turns its published URL into a 404 for anyone coming from an existing bookmark, search result, or external link. I checked docs/redirects.csv:913-962: it already contains redirects for many sibling .../Overview pages (including the classic QBO page removed in this commit), but not for this URL or the other four unredirected overview pages deleted here, so those old article links will now break instead of forwarding to the troubleshooting hub.

Useful? React with 👍 / 👎.

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