From 86c26feafb8c52d5a0e295d07aa8f12802961556 Mon Sep 17 00:00:00 2001 From: Tor Brede Vekterli Date: Mon, 20 Jan 2025 11:21:25 +0100 Subject: [PATCH] Minor grammar fixes and a few added clarifications --- en/documents.html | 5 +++-- en/overview.html | 2 +- en/query-api.html | 2 +- en/reads-and-writes.html | 4 ++-- en/schemas.html | 2 +- 5 files changed, 8 insertions(+), 7 deletions(-) diff --git a/en/documents.html b/en/documents.html index 236127e965..dd33838a29 100644 --- a/en/documents.html +++ b/en/documents.html @@ -11,7 +11,7 @@ defined in the schema.

When configuring clusters, a documents - element set what document types a cluster is to store. + element sets what document types a cluster is to store. This configuration is used to configure the garbage collector if it is enabled. Additionally, it is used to define default routes for documents sent into the application. By default, a document will be sent to all clusters having the document type defined. @@ -259,8 +259,9 @@

Document expiry

When garbage-collection="true", Vespa iterates over the document space to purge expired documents. - Vespa will invoke the configured GC selection for each stored document at most once every + Vespa will invoke the configured GC selection for each stored document once every garbage-collection-interval seconds. + It is unspecified when a particular document will be processed within the configured interval.

{% include important.html content="This is a best-effort garbage collection feature to conserve CPU and space. Use query filters if it is important to exclude documents based on a criterion."%} diff --git a/en/overview.html b/en/overview.html index 7a2da86826..a34e54d739 100644 --- a/en/overview.html +++ b/en/overview.html @@ -91,7 +91,7 @@

Vespa operations

free-text fields, structured data or vector spaces (ANN). Any number of such conditions can be combined freely in boolean trees to define the full query to be executed. - Vespa will compute a query plan over the conditions which executed them + Vespa will compute a query plan over the conditions which executes them efficiently with any number of conditions such as e.g. filters combined with ANN conditions. Matches to a query can be passed through an inference step which can compute any business logic or machine-learned model expressed as a diff --git a/en/query-api.html b/en/query-api.html index 352da3eb52..b2f67769da 100644 --- a/en/query-api.html +++ b/en/query-api.html @@ -397,7 +397,7 @@

Matching, ranking, grouping

  • At this point the query enters one or more content clusters. In a content cluster with grouped distribution, - the query is dispatched to one group at a time using a + the query is dispatched to all content nodes within a single group using a dispatch policy, while with a flat single group content cluster the query is dispatched to all content nodes.
  • diff --git a/en/reads-and-writes.html b/en/reads-and-writes.html index 491577b391..f164750116 100644 --- a/en/reads-and-writes.html +++ b/en/reads-and-writes.html @@ -88,7 +88,7 @@

    Operations

    for test-and-set use cases.

    A removed document is written as a tombstone, and later garbage collected - - see removed-db / prune /age. + see removed-db / prune / age. Vespa does not retain, nor return, the document data of removed documents.

    @@ -98,7 +98,7 @@

    Operations

    Also referred to as partial updates, as it updates one or more fields of a document by ID - the document v1 API can be used to perform - updates in the JSON Document format, + updates in the JSON Document format. If the document to update is not found, it is not considered a failure.

    Updates support create if nonexistent (upsert). diff --git a/en/schemas.html b/en/schemas.html index a0e53f63d8..7d2b8323c3 100644 --- a/en/schemas.html +++ b/en/schemas.html @@ -520,7 +520,7 @@

    Inheritance

    Schema elements that support inheritance -{% include note.html content="Inheritance is not to confuse with parent/child, +{% include note.html content="Inheritance is not to be confused with parent/child, which is a feature to import field values at query time."%}