fix following pill comments

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: mozzius

src/features/followingV2/home/PostFeed.tsx

@@ -484,9 +484,9 @@ let PostFeed = ({
   /*
    * Anchored Following's checks, made by the view on screen only. Each one
    * that finds newer posts stages them above the reader at rest (see
-   * `usePostFeedPrepend`) and lights the Home dot. Only one on a significant
-   * return to the app, or one that joins a restore's prepend, offers them with
-   * the pill. With no boundary to fetch above, as for an empty feed, it peeks
+   * `usePostFeedPrepend`) and lights the Home dot. A significant return or a
+   * restore puts the pill up for them, and while it's up every check's find
+   * joins it. With no boundary to fetch above, as for an empty feed, it peeks
    * for the Home dot instead, as other feeds do.
    */
   useNewPostsCheck({

src/features/followingV2/home/queries/postFeed.ts

@@ -628,9 +628,9 @@ function isSameFeedItem(
  * While a page is staged, the next prepend fetches from the same `since` as it
  * did and replaces it, so however long the reader stays put, what's above them
  * is one page of at most {@link PREPEND_LIMIT} posts. Once it's read, the next
- * one goes above it. `staged` is the page for the pill, which goes up if a
- * restore or a significant return to the app put it there, or `check` has
- * offered it since, and takes in every page staged while it's up.
+ * one goes above it. The pill goes up for a `staged` page that a restore or a
+ * significant return put there, or that `check` has offered since, and takes
+ * in every page staged while it's up (see `usePrependPill`).
  *
  * A page only ever replaces the staged one if it has all of its posts, as
  * the list holds the reader's place only for posts added above the others:
@@ -796,10 +796,7 @@ export function usePostFeedPrepend(
     }
     setStaged({
       fetchedAt: page.fetchedAt,
-      /*
-       * Only if this prepend offers it: the pill keeps a page that replaces
-       * one it has, while it's up.
-       */
+      // A replacement isn't offered. The pill takes it in itself if it's up.
       offered: isOffering.current,
       isFull,
     })

src/features/followingV2/home/useSettleScrollHandlers.ts

@@ -12,8 +12,7 @@ import {SETTLE_AT_TOP_LIMIT, type SettleAtTopHandlers} from './useSettleAtTop'
 
 /**
  * What the list reports on the JS thread: what {@link SettleAtTopHandlers}
- * need, and when it reaches its top, which reads the posts staged above the
- * reader (see `usePostFeedPrepend`) and takes the pill down.
+ * need, and when it reaches its top.
  */
 export type ListScrollReports = SettleAtTopHandlers & {
   /** A scroll event found the list at the top where the last one didn't. */