Help center: five orphan placeholder articles sit in Featurebase with no content — write or delete them (one duplicates a live article)

What

pnpm docs:sync:pull surfaces five articles that exist in Featurebase but had never been committed. All five are abandoned docs:sync:new reservations, not dashboard-authored content — every one carries the literal placeholder body <p>… — draft. Replace this body before merging.</p>, is state: "draft", and has no icon.

They were committed to the repo in PR for TPTM-3407 (commit 7ab044ebd) so the debt is visible and tracked rather than re-surfacing on every pull. Committing them did not resolve them — the repo now carries five articles whose source of truth says "Replace this body before merging".

| id | title | collection | | -- | -- | -- | | 2617421 | Connect Claude to TPTM | builder-configuration | | 8347566 | AI Connectors | builder-configuration | | 9982008 | Connect Perplexity to TPTM | builder-configuration | | 6660540 | On-screen Messages | user-guides | | 1505935 | Manager View | tracking-progress |

The duplicate

1505935 "Manager View" duplicates a live article. The real one is 3991535-manager-view — 136 lines, a full description, an icon, state: "live", in the same tracking-progress collection. 1505935 is a 12-line placeholder that was reserved with almost the same title and never filled in.

It should be deleted, not written. Two of its titles would otherwise compete in help-centre search and in the AI support assistant's corpus the moment anyone flipped it live.

Why this needs a human

Deleting an article is a Featurebase dashboard action — the sync deliberately cannot do it, and docs/help-center/README.md records that deleting the file only produces an "orphan" report. So each of the five needs a decision:

  • 1505935 — delete in the dashboard, then git rm the file. (Recommended; it duplicates 3991535.)
  • 2617421 / 8347566 / 9982008 — the three AI-connector articles look like genuinely planned work. Either write them or delete them.
  • 6660540 "On-screen Messages" — no description either; decide whether this is still wanted.

Acceptance criteria

  • [ ] Each of the five is either written (real body + description, passing pnpm docs:audit --id <id>) or deleted in the Featurebase dashboard with its file removed from the repo.
  • [ ] 1505935 specifically is resolved against 3991535 rather than written as a second Manager View article.
  • [ ] pnpm docs:sync:pull afterwards produces no untracked placeholder files.

Notes

Pre-existing, unrelated debt found in the same sweep, NOT part of this ticket: _uncategorized/0218204 and _uncategorized/1311207 are both "Understanding Lot Holds" with real (duplicated) content, and admin-portal/8847914 is titled "This is the title" with Featurebase's own element-reference body. Those are already committed and have their own history.

Please authenticate to join the conversation.

Upvoters
Status

Completed

Board
💡

Feature Request

Date

About 6 hours ago

Author

Linear

Subscribe to request

Get notified by email when there are changes.