Skip to content

Commit ddc67b8

Browse files
authored
Fix a few grammar issues and typos (#28332)
* Fix few grammar issues and typos in the blog page > see the API documentation more information Should be corrected to "documentation for more information" as the sentence is incorrect. > may only compare two resource version for equality Everywhere else in the paragraph "resource versions" are used, I believe this is just a typo. > The get, list and watch Missing comma after list to separate the elements * Fix typos in blog post > On rare occurences, a "occurrences" is misspelled > whole list, map or struct 3 elements are missing a comma seperator after map > there are no way are is a plural form while "no way" is a singular subject > `MergePatch`, `StrategicMergePatch`, `JSONPatch` or `Update` Missing comma after JSONPatch
1 parent 6852192 commit ddc67b8

File tree

2 files changed

+7
-7
lines changed

2 files changed

+7
-7
lines changed

content/en/docs/reference/using-api/api-concepts.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Some resource types will have one or more sub-resources, represented as sub path
4949
* Cluster-scoped subresource: `GET /apis/GROUP/VERSION/RESOURCETYPE/NAME/SUBRESOURCE`
5050
* Namespace-scoped subresource: `GET /apis/GROUP/VERSION/namespaces/NAMESPACE/RESOURCETYPE/NAME/SUBRESOURCE`
5151

52-
The verbs supported for each subresource will differ depending on the object - see the API documentation more information. It is not possible to access sub-resources across multiple resources - generally a new virtual resource type would be used if that becomes necessary.
52+
The verbs supported for each subresource will differ depending on the object - see the API documentation for more information. It is not possible to access sub-resources across multiple resources - generally a new virtual resource type would be used if that becomes necessary.
5353

5454

5555
## Efficient detection of changes
@@ -442,7 +442,7 @@ feature, see the section on
442442

443443
## Resource Versions
444444

445-
Resource versions are strings that identify the server's internal version of an object. Resource versions can be used by clients to determine when objects have changed, or to express data consistency requirements when getting, listing and watching resources. Resource versions must be treated as opaque by clients and passed unmodified back to the server. For example, clients must not assume resource versions are numeric, and may only compare two resource version for equality (i.e. must not compare resource versions for greater-than or less-than relationships).
445+
Resource versions are strings that identify the server's internal version of an object. Resource versions can be used by clients to determine when objects have changed, or to express data consistency requirements when getting, listing and watching resources. Resource versions must be treated as opaque by clients and passed unmodified back to the server. For example, clients must not assume resource versions are numeric, and may only compare two resource versions for equality (i.e. must not compare resource versions for greater-than or less-than relationships).
446446

447447
### ResourceVersion in metadata
448448

@@ -454,7 +454,7 @@ Clients find resource versions in resources, including the resources in watch ev
454454

455455
### The ResourceVersion Parameter
456456

457-
The get, list and watch operations support the `resourceVersion` parameter.
457+
The get, list, and watch operations support the `resourceVersion` parameter.
458458

459459
The exact meaning of this parameter differs depending on the operation and the value of `resourceVersion`.
460460

content/en/docs/reference/using-api/server-side-apply.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -245,15 +245,15 @@ field tags.
245245

246246
### Compatibility across topology changes
247247

248-
On rare occurences, a CRD or built-in type author may want to change the
248+
On rare occurrences, a CRD or built-in type author may want to change the
249249
specific topology of a field in their resource without incrementing its
250250
version. Changing the topology of types, by upgrading the cluster or
251251
updating the CRD, has different consequences when updating existing
252252
objects. There are two categories of changes: when a field goes from
253253
`map`/`set`/`granular` to `atomic` and the other way around.
254254

255255
When the `listType`, `mapType`, or `structType` changes from
256-
`map`/`set`/`granular` to `atomic`, the whole list, map or struct of
256+
`map`/`set`/`granular` to `atomic`, the whole list, map, or struct of
257257
existing objects will end-up being owned by actors who owned an element
258258
of these types. This means that any further change to these objects
259259
would cause a conflict.
@@ -310,7 +310,7 @@ simplify the update logic of your controller. The main differences with a
310310
read-modify-write and/or patch are the following:
311311

312312
* the applied object must contain all the fields that the controller cares about.
313-
* there are no way to remove fields that haven't been applied by the controller
313+
* there is no way to remove fields that haven't been applied by the controller
314314
before (controller can still send a PATCH/UPDATE for these use-cases).
315315
* the object doesn't have to be read beforehand, `resourceVersion` doesn't have
316316
to be specified.
@@ -473,7 +473,7 @@ have an opinion about.
473473
## Clearing ManagedFields
474474

475475
It is possible to strip all managedFields from an object by overwriting them
476-
using `MergePatch`, `StrategicMergePatch`, `JSONPatch` or `Update`, so every
476+
using `MergePatch`, `StrategicMergePatch`, `JSONPatch`, or `Update`, so every
477477
non-apply operation. This can be done by overwriting the managedFields field
478478
with an empty entry. Two examples are:
479479

0 commit comments

Comments
 (0)