docs: document tweet conversations

This commit is contained in:
2026-07-14 01:28:23 +09:00
parent fa26ce18d7
commit acc4fe841b
3 changed files with 31 additions and 1 deletions
+9
View File
@@ -9,11 +9,16 @@ enter a user handle, profile URL, or search query.
- Popular (`Top`) and chronological (`Latest`) search
- Optional `filter:follows` search
- Infinite cursor pagination with explicit retry
- Deliberate post detail pages with the visible conversation
- Infinite conversation loading with explicit continuation retry
- Read-only cards for text, media, quotes, articles, and quiet engagement counts
It intentionally has no home feed, recommendations, trends, notifications,
history, account directory, or write actions.
Post detail pages show only the selected post and its visible conversation;
they do not add related-post recommendations or an account-discovery surface.
## Requirements and setup
Use Nix, or Node.js `>=22.12.0` with pnpm `11.9.0`. The package link also
@@ -72,3 +77,7 @@ only on a trusted network and obtain the Tailscale address with
Bird uses X's internal GraphQL operations through the configured relay. Query
IDs and response shapes can change without notice.
Conversation pages use Bird's current per-page chronological ordering. Keeping
X's original ranked branch order is deferred until Bird exposes that order
without expanding the relay surface.