docs(firestore): fixing translation mistakes and changing to concepts vs code

Author: rafikhan

packages/firestore/devdocs/garbage-collection.md

@@ -35,15 +35,15 @@ A document is only eligible for collection if it is **Orphaned**. A document is
 ## Key Concepts
 
 ### Sequence Numbers (The Logical Clock)
-To determine "recency," the SDK maintains a global `last_sequence_number` in the `target_globals` table.
+To determine "recency," the SDK maintains a global `lastListenSequenceNumber` in the **Target Globals** store (`targetGlobal`).
 *   **Tick**: Every transaction (write, query listen, remote update) increments this number.
-*   **Tagging**: When a Target is actively listened to or updated, its `last_listen_sequence_number` is updated to the current global tick.
+*   **Tagging**: When a Target is actively listened to or updated, its `lastListenSequenceNumber` is updated to the current global tick.
 *   **Effect**: Higher numbers = More recently used.
 
-### The Reference Map (`target_documents`)
-This table acts as a reference counter linking Documents to Targets.
-*   **Active Association**: If `target_id: 2` matches `doc_key: A`, a row exists.
-*   **Sentinel Rows (`target_id: 0`)**: If a document exists in the cache but is not matched by *any* specific target (perhaps previously downloaded, or part of a target that was deleted), it may have a row with `target_id: 0`. This marks the document as present but potentially orphaned.
+### The Reference Map (`targetDocuments`)
+The **Target-Document Index** (`targetDocuments`) acts as a reference counter linking Documents to Targets.
+*   **Active Association**: If `targetId: 2` matches `documentKey: A`, a row exists.
+*   **Sentinel Rows (`targetId: 0`)**: If a document exists in the cache but is not matched by *any* specific target (perhaps previously downloaded, or part of a target that was deleted), it may have a row with `targetId: 0`. This marks the document as present but potentially orphaned.
 
 ## The Collection Algorithm
 
@@ -52,11 +52,11 @@ The `LruGarbageCollector` runs periodically (e.g., every few minutes).
 1.  **Threshold Check**: It calculates the byte size of the current cache. If `CurrentSize < CacheSizeBytes` (default 100MB), the process aborts.
 2.  **Calculate Cutoff**:
     *   The GC decides how many items to cull (e.g., 10%).
-    *   It queries the `target_documents` table, ordered by `sequence_number` ASC.
+    *   It queries the **Target-Document Index** (`targetDocuments`) table, ordered by `sequenceNumber` ASC.
     *   It finds the sequence number at the 10th percentile. This becomes the **Upper Bound**.
 3.  **Sweep Targets**:
-    *   Any Target in the `targets` table with a `last_listen_sequence_number` <= **Upper Bound** is deleted.
+    *   Any Target in the **Targets** table (`targets`) with a `lastListenSequenceNumber` <= **Upper Bound** is deleted.
     *   This removes the "Active" link for any documents associated with that target.
 4.  **Sweep Documents**:
-    *   The GC scans for documents that have *no* rows in `target_documents` (or only sentinel rows) AND have a sequence number <= **Upper Bound**.
-    *   These "Orphaned" documents are deleted from the `remote_documents` table.
+    *   The GC scans for documents that have *no* rows in **Target-Document Index** (or only sentinel rows) AND have a sequence number <= **Upper Bound**.
+    *   These "Orphaned" documents are deleted from the **Remote Document Cache** (`remoteDocuments`).

packages/firestore/devdocs/overview.md

@@ -58,9 +58,9 @@ To navigate the internals of the SDK, use the following guide:
 *   **[Write Lifecycle](./write-lifecycle.md)**: How writes work (Mutations, Batches, Overlays).
 
 ### Subsystem Deep Dives
-*   **[Persistence Schema](./persistence-schema.md)**: A reference guide for the IndexedDB tables.
-*   **[Garbage Collection](./garbage-collection.md)**: Details the LRU algorithm, Sequence Numbers, and how the SDK manages cache size.
 *   **[Query Execution](./query-execution.md)**: Details on the algorithms used by the Local Store to execute queries (Index Scans vs. Full Collection Scans).
+*   **[Garbage Collection](./garbage-collection.md)**: Details the LRU algorithm, Sequence Numbers, and how the SDK manages cache size.
+*   **[Persistence Schema](./persistence-schema.md)**: A reference guide for the IndexedDB tables.
 *   **[Transactions](./transactions.md)**: How the SDK implements Optimistic Concurrency Control, retries, and the online-only write pipeline.
 *   **[Limbo Resolution](./limbo-resolution.md)**: How the SDK detects and cleans up stale data using Existence Filters and Bloom Filters.
 *   **[Bundles](./bundles.md)**: How the SDK loads and processes data bundles.

packages/firestore/devdocs/persistence-schema.md

@@ -6,57 +6,63 @@ While the Android/iOS SDKs use SQLite, the JS SDK uses IndexedDB Object Stores.
 
 ## Core Object Stores
 
-### `remote_documents`
+### Remote Document Cache
 *   **Concept**: The client's cache of the backend's "Source of Truth."
+*   **Implementation**: Stored in `remoteDocuments` (legacy: `remoteDocumentsV14`).
 *   **Key**: `DocumentKey` (Path to the document).
 *   **Value**:
     *   **Document Data**: The serialized Protobuf of the document.
     *   **ReadTime**: The snapshot version at which this document was read.
-*   **Note**: This store **never** contains local, unacknowledged writes. It only contains data confirmed by the server. To see what the developer sees, we overlay the `mutation_queue` on top of this.
+*   **Note**: This store **never** contains local, unacknowledged writes. It only contains data confirmed by the server. To see what the developer sees, we overlay the **Mutation Queue** on top of this.
 
-### `mutation_queue`
+### Mutation Queue
 *   **Concept**: The "Pending Writes" queue. An ordered log of all local writes that have not yet been acknowledged by the server.
-*   **Key**: `(user_id, batch_id)`. Segregating by User ID ensures that if a user logs out, their pending writes do not leak to the next user.
-*   **Value**: A serialized `MutationBatch` containing one or more mutations (Set, Patch, Delete).
-*   **Behavior**: This is the "Single Source of Truth" for local changes. If the app restarts, the SDK replays these mutations to rebuild the Overlays. When the network is available, the `RemoteStore` reads from this queue to send write batches to the backend. Once acknowledged, entries are removed.
+*   **Implementation**: Split across `mutationQueues` (User Metadata) and `mutations` (Batch Data).
+*   **Key**: `(userId, batchId)`. Segregating by User ID ensures that if a user logs out, their pending writes do not leak to the next user.
+*   **Value**: A serialized `DbMutationBatch` containing one or more mutations (Set, Patch, Delete).
+*   **Behavior**: This is the "Single Source of Truth" for local changes. If the app restarts, the SDK replays these mutations to rebuild the **Document Overlays**. When the network is available, the `RemoteStore` reads from this queue to send write batches to the backend. Once acknowledged, entries are removed.
 
-### `document_overlays`
+### Document Overlays
 *   **Concept**: A cache of the *result* of applying pending mutations.
-*   **Key**: `(user_id, document_key)`.
+*   **Implementation**: Stored in `documentOverlays`.
+*   **Key**: `(userId, documentKey)`.
 *   **Purpose**: Read Performance. Without this table, the SDK would have to read the Remote Document and re-apply every pending mutation from the queue every time a query ran.
 *   **Lifecycle**: Created immediately when a user writes. Deleted immediately when the backend acknowledges the write (or rejects it).
-*   **Priority**: When the `LocalStore` reads a document, it checks this table first. If an entry exists, it takes precedence over `remote_documents`.
+*   **Priority**: When the `LocalStore` reads a document, it checks this table first. If an entry exists, it takes precedence over **Remote Document Cache**.
 
-### `targets`
+### Targets
 *   **Concept**: Metadata about active and cached queries.
-*   **Key**: `TargetID` (Internal Integer allocated by `SyncEngine`).
+*   **Implementation**: Stored in `targets`.
+*   **Key**: `TargetId` (Internal Integer allocated by `SyncEngine`).
 *   **Value**:
     *   **Canonical ID**: A hash string representing the query (filters, sort order). Used for deduplication.
     *   **Resume Token**: An opaque token from the backend used to resume a stream without re-downloading all data.
     *   **Last Sequence Number**: Used for Garbage Collection (LRU).
 
-### `target_documents` (The Index)
-*   **Concept**: A reverse index mapping `TargetID` $\leftrightarrow$ `DocumentKey`.
+### Target-Document Index
+*   **Concept**: A reverse index mapping `TargetId` $\leftrightarrow$ `DocumentKey`.
+*   **Implementation**: Stored in `targetDocuments`.
 *   **Purpose**:
     1.  **Query Execution**: Quickly identify documents for a query.
-    2.  **Garbage Collection**: Acts as a reference counter. If a document has entries here with active TargetIDs, it cannot be collected.
-*   **Sentinel Rows**: A row with `TargetID = 0` indicates the document exists in the cache but may not be attached to any active listener. These are primary candidates for Garbage Collection.
+    2.  **Garbage Collection**: Acts as a reference counter. If a document has entries here with active `TargetId`s, it cannot be collected.
+*   **Sentinel Rows**: A row with `TargetId = 0` indicates the document exists in the cache but may not be attached to any active listener. These are primary candidates for Garbage Collection.
 *   **Maintenance**: This is updated whenever a remote snapshot adds/removes a document from a query view.
 
 ## Metadata & Garbage Collection Stores
 
-### `target_globals`
+### Target Globals
 *   **Concept**: A singleton store for global system state.
+*   **Implementation**: Stored in `targetGlobal`.
 *   **Key**: Fixed singleton key.
 *   **Value**:
-    *   **`last_sequence_number`**: A global integer counter incremented on every transaction.
-    *   **`target_count`**: Number of targets currently tracked.
+    *   **`lastListenSequenceNumber`**: A global integer counter incremented on every transaction.
+    *   **`targetCount`**: Number of targets currently tracked.
 
-### `remote_document_changes` (Ephemeral)
+### Remote Document Changes (Ephemeral)
 *   **Concept**: A temporary staging area used during `SyncEngine` processing.
-*   **Purpose**: Used to track read-time updates for documents during a remote event application before they are committed to the main `remote_documents` store.
+*   **Purpose**: Used to track read-time updates for documents during a remote event application before they are committed to the main **Remote Document Cache**.
 
 ## Data Relationships
 
-1.  **The "View"**: To construct a document for the developer, the SDK reads `remote_documents[key]` and applies any mutations found in `mutation_queue` matching that key.
-2.  **Garbage Collection**: The `LruGarbageCollector` uses `target_globals.last_sequence_number` and `targets.last_sequence_number` to determine which targets are old and can be evicted. It then uses `target_documents` to find which documents are no longer referenced by *any* target and deletes them from `remote_documents`.
+1.  **The "View"**: To construct a document for the developer, the SDK reads **Remote Document Cache** and applies any mutations found in **Mutation Queue** matching that key.
+2.  **Garbage Collection**: The `LruGarbageCollector` uses `TargetGlobal.lastListenSequenceNumber` and `Target.lastListenSequenceNumber` to determine which targets are old and can be evicted. It then uses **Target-Document Index** to find which documents are no longer referenced by *any* target and deletes them from **Remote Document Cache**.