Merge pull request #73996 from johnwilkins/OSDOCS-10115

OSDOCS-10115: Remove contractions

Author: mburke5678

modules/builds-using-build-volumes.adoc

@@ -9,7 +9,7 @@ endif::[]
 [id="builds-using-build-volumes_{context}"]
 = Using build volumes
 
-You can mount build volumes to give running builds access to information that you don't want to persist in the output container image.
+You can mount build volumes to give running builds access to information that you do not want to persist in the output container image.
 
 Build volumes provide sensitive information, such as repository credentials, that the build environment or configuration only needs at build time. Build volumes are different from xref:../../cicd/builds/creating-build-inputs.adoc#builds-define-build-inputs_creating-build-inputs[build inputs], whose data can persist in the output container image.
 
@@ -55,7 +55,7 @@ spec:
               attribute: value
 ----
 <1> Required. A unique name.
-<2> Required. The absolute path of the mount point. It must not contain `..` or `:` and doesn't collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
+<2> Required. The absolute path of the mount point. It must not contain `..` or `:` and does not collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
 <3> Required. The type of source, `ConfigMap`, `Secret`, or `CSI`.
 <4> Required. The name of the source.
 <5> Required. The driver that provides the ephemeral CSI volume.
@@ -105,7 +105,7 @@ spec:
 ----
 
 <1> Required. A unique name.
-<2> Required. The absolute path of the mount point. It must not contain `..` or `:` and doesn't collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
+<2> Required. The absolute path of the mount point. It must not contain `..` or `:` and does not collide with the destination path generated by the builder. The `/opt/app-root/src` is the default home directory for many Red Hat S2I-enabled images.
 <3> Required. The type of source, `ConfigMap`, `Secret`, or `CSI`.
 <4> Required. The name of the source.
 <5> Required. The driver that provides the ephemeral CSI volume.

modules/cluster-cloud-controller-config-osp.adoc

@@ -191,7 +191,7 @@ This option is unsupported if you use {rh-openstack} earlier than version 17 wit
 // | The id of the loadbalancer flavor to use. Uses octavia default if not set.
 
 // | `availability-zone`
-// | The name of the loadbalancer availability zone to use. The Octavia availability zone capabilities will not be used if it is not set. The parameter will be ignored if the Octavia version doesn't support availability zones yet.
+// | The name of the loadbalancer availability zone to use. The Octavia availability zone capabilities will not be used if it is not set. The parameter will be ignored if the Octavia version does not support availability zones yet.
 
 | `LoadBalancerClass "ClassName"`
 a| This is a config section that comprises a set of options:

modules/cluster-logging-elasticsearch-rules.adoc

@@ -17,7 +17,7 @@ You can view these alerting rules in the {product-title} web console.
 
 |`ElasticsearchClusterNotHealthy`
 |The cluster health status has been RED for at least 2 minutes. The cluster does not accept writes, shards may be missing, or the master
- node hasn't been elected yet.
+ node has not been elected yet.
 |Critical
 
 |`ElasticsearchClusterNotHealthy`

modules/cluster-logging-exported-fields-top-level-fields.adoc

@@ -79,7 +79,7 @@ The following values come from link:http://sourceware.org/git/?p=glibc.git;a=blo
 The two following values are not part of `syslog.h` but are widely used:
 
 * `8` = `trace`, trace-level messages, which are more verbose than `debug` messages.
-* `9` = `unknown`, when the logging system gets a value it doesn't recognize.
+* `9` = `unknown`, when the logging system gets a value it does not recognize.
 
 Map the log levels or priorities of other logging systems to their nearest match in the preceding list. For example, from link:https://docs.python.org/2.7/library/logging.html#logging-levels[python logging], you can match `CRITICAL` with `crit`, `ERROR` with `err`, and so on.
 

modules/cnf-configure_for_irq_dynamic_load_balancing.adoc

@@ -118,7 +118,7 @@ Starting pod/<node-name>-debug ...
 To use host binaries, run `chroot /host`
 
 Pod IP: <ip-address>
-If you don't see a command prompt, try pressing enter.
+If you do not see a command prompt, try pressing enter.
 
 sh-4.4#
 ----

modules/creating-your-first-content.adoc

@@ -96,7 +96,7 @@ Topics:
 ----
 
 . On the command line, run `asciibinder` from the root folder of openshift-docs.
-You don't have to add or commit your changes for asciibinder to run.
+You do not have to add or commit your changes for asciibinder to run.
 
 . After the asciibinder build completes, open up your browser and navigate to
 <YOUR-LOCAL-GIT-REPO-LOCATION>/openshift-docs/_preview/openshift-enterprise/my_first_mod_docs/my_guide/assembly_my-first-assembly.html
@@ -105,4 +105,4 @@ You don't have to add or commit your changes for asciibinder to run.
 contents from your module `My First Module`.
 
 NOTE: You can delete this branch now if you are done testing. This branch
-shouldn't be submitted to the upstream openshift-docs repository.
+should not be submitted to the upstream openshift-docs repository.

modules/dynamic-plugin-api.adoc

@@ -122,7 +122,7 @@ Component for displaying an error status popover.
 |Parameter Name |Description
 |`title` |(optional) status text
 |`iconOnly` |(optional) if true, only displays icon
-|`noTooltip` |(optional) if true, tooltip won't be displayed
+|`noTooltip` |(optional) if true, tooltip is not displayed
 |`className` |(optional) additional class name for the component
 |`popoverTitle` |(optional) title for popover
 |===
@@ -143,7 +143,7 @@ Component for displaying an information status popover.
 |Parameter Name |Description
 |`title` |(optional) status text
 |`iconOnly` |(optional) if true, only displays icon
-|`noTooltip` |(optional) if true, tooltip won't be displayed
+|`noTooltip` |(optional) if true, tooltip is not displayed
 |`className` |(optional) additional class name for the component
 |`popoverTitle` |(optional) title for popover
 |===
@@ -164,7 +164,7 @@ Component for displaying a progressing status popover.
 |Parameter Name |Description
 |`title` |(optional) status text
 |`iconOnly` |(optional) if true, only displays icon
-|`noTooltip` |(optional) if true, tooltip won't be displayed
+|`noTooltip` |(optional) if true, tooltip is not displayed
 |`className` |(optional) additional class name for the component
 |`popoverTitle` |(optional) title for popover
 |===
@@ -185,7 +185,7 @@ Component for displaying a success status popover.
 |Parameter Name |Description
 |`title` |(optional) status text
 |`iconOnly` |(optional) if true, only displays icon
-|`noTooltip` |(optional) if true, tooltip won't be displayed
+|`noTooltip` |(optional) if true, tooltip is not displayed
 |`className` |(optional) additional class name for the component
 |`popoverTitle` |(optional) title for popover
 |===
@@ -219,7 +219,7 @@ Hook that provides information about user access to a given resource. It returns
 
 React hook for consuming Console extensions with resolved `CodeRef` properties. This hook accepts the same argument(s) as `useExtensions` hook and returns an adapted list of extension instances, resolving all code references within each extension's properties.
 
-Initially, the hook returns an empty array. After the resolution is complete, the React component is re-rendered with the hook returning an adapted list of extensions. When the list of matching extensions changes, the resolution is restarted. The hook will continue to return the previous result until the resolution completes.
+Initially, the hook returns an empty array. After the resolution is complete, the React component is re-rendered with the hook returning an adapted list of extensions. When the list of matching extensions changes, the resolution is restarted. The hook continues to return the previous result until the resolution completes.
 
 The hook's result elements are guaranteed to be referentially stable across re-renders. It returns a tuple containing a list of adapted extension instances with resolved code references, a boolean flag indicating whether the resolution is complete, and a list of errors detected during the resolution.
 
@@ -364,7 +364,7 @@ A hook that provides a list of user-selected active TableColumns.
 TableColumns
 
 |`\{boolean} [options.showNamespaceOverride]` |(optional) If true, a
-namespace column will be included, regardless of column management
+namespace column is included, regardless of column management
 selections
 
 |`\{string} [options.columnManagementID]` |(optional) A unique ID
@@ -757,7 +757,7 @@ const Component: React.FC = () => {
 |===
 |Parameter Name |Description
 |`initResources` |Resources must be watched as key-value pair,
-wherein key will be unique to resource and value will be options needed
+wherein key is unique to resource and value is options needed
 to watch for the respective resource.
 |===
 
@@ -837,8 +837,8 @@ model. In case of failure, the promise gets rejected with HTTP error response.
 
 |`options.model` |k8s model
 
-|`options.name` |The name of the resource, if not provided then it will
-look for all the resources matching the model.
+|`options.name` |The name of the resource, if not provided then it
+looks for all the resources matching the model.
 
 |`options.ns` | The namespace to look into, should not be specified
 for cluster-scoped resources.
@@ -949,7 +949,7 @@ request headers, method, redirect, etc. See link:{power-bi-url}[Interface Reques
 
 
 |`options.json` |Can control garbage collection of resources
-explicitly if provided else will default to model's "propagationPolicy".
+explicitly if provided or else it defaults to the model's "propagationPolicy".
 |===
 
 [discrete]
@@ -990,7 +990,7 @@ Provides apiVersion for a k8s model.
 [discrete]
 == `getGroupVersionKindForResource`
 
-Provides a group, version, and kind for a resource. It returns the group, version, kind for the provided resource. If the resource does not have an API group, group "core" will be returned. If the resource has an invalid apiVersion, then it will throw an Error.
+Provides a group, version, and kind for a resource. It returns the group, version, kind for the provided resource. If the resource does not have an API group, group "core" is returned. If the resource has an invalid apiVersion, then it throws an Error.
 
 [cols=",",options="header",]
 |===
@@ -1001,7 +1001,7 @@ Provides a group, version, and kind for a resource. It returns the group, versio
 [discrete]
 == `getGroupVersionKindForModel`
 
-Provides a group, version, and kind for a k8s model. This returns the group, version, kind for the provided model. If the model does not have an apiGroup, group "core" will be returned.
+Provides a group, version, and kind for a k8s model. This returns the group, version, kind for the provided model. If the model does not have an apiGroup, group "core" is returned.
 
 [cols=",",options="header",]
 |===
@@ -1294,7 +1294,7 @@ the editor. This prop is used only during the initial render
 
 |`header` |Add a header on top of the YAML editor
 
-|`onSave` |Callback for the Save button. Passing it will override the
+|`onSave` |Callback for the Save button. Passing it overrides the
 default update performed on the resource by the editor
 |===
 
@@ -1404,7 +1404,7 @@ Component that allows to receive contributions from other plugins for the `conso
 [discrete]
 == `NamespaceBar`
 
-A component that renders a horizontal toolbar with a namespace dropdown menu in the leftmost position. Additional components can be passed in as children and will be rendered to the right of the namespace dropdown. This component is designed to be used at the top of the page. It should be used on pages where the user needs to be able to change the active namespace, such as on pages with k8s resources.
+A component that renders a horizontal toolbar with a namespace dropdown menu in the leftmost position. Additional components can be passed in as children and is rendered to the right of the namespace dropdown. This component is designed to be used at the top of the page. It should be used on pages where the user needs to be able to change the active namespace, such as on pages with k8s resources.
 
 .Example
 [source,text]
@@ -1429,7 +1429,7 @@ namespace option is selected. It accepts the new namespace in the form
 of a string as its only argument. The active namespace is updated
 automatically when an option is selected, but additional logic can be
 applied via this function. When the namespace is changed, the namespace
-parameter in the URL will be changed from the previous namespace to the
+parameter in the URL is changed from the previous namespace to the
 newly selected namespace.
 
 |`isDisabled` |(optional) A boolean flag that disables the namespace
@@ -1493,14 +1493,14 @@ A component that renders a graph of the results from a Prometheus PromQL query a
 |`customDataSource` |(optional) Base URL of an API endpoint that handles PromQL queries. If provided, this is used instead of the default API for fetching data.
 |`defaultSamples` |(optional) The default number of data samples plotted for each data series. If there are many data series, QueryBrowser might automatically pick a lower number of data samples than specified here.
 |`defaultTimespan` |(optional) The default timespan for the graph in milliseconds - defaults to 1,800,000 (30 minutes).
-|`disabledSeries` |(optional) Disable (don't display) data series with these exact label / value pairs.
+|`disabledSeries` |(optional) Disable (do not display) data series with these exact label / value pairs.
 |`disableZoom` |(optional) Flag to disable the graph zoom controls.
 |`filterLabels` |(optional) Optionally filter the returned data series to only those that match these label / value pairs.
 |`fixedEndTime` |(optional) Set the end time for the displayed time range rather than showing data up to the current time.
 |`formatSeriesTitle` |(optional) Function that returns a string to use as the title for a single data series.
 |`GraphLink` |(optional) Component for rendering a link to another page (for example getting more information about this query).
 |`hideControls` |(optional) Flag to hide the graph controls for changing the graph timespan, and so on.
-|`isStack` |(optional) Flag to display a stacked graph instead of a line graph. If showStackedControl is set, it will still be possible for the user to switch to a line graph.
+|`isStack` |(optional) Flag to display a stacked graph instead of a line graph. If showStackedControl is set, it is still possible for the user to switch to a line graph.
 |`namespace` |(optional) If provided, data is only returned for this namespace (only series that have this namespace label).
 |`onZoom` |(optional) Callback called when the graph is zoomed.
 |`pollInterval` |(optional) If set, determines how often the graph is updated to show the latest data (in milliseconds).
@@ -1533,7 +1533,7 @@ const PodAnnotationsButton = ({ pod }) => {
 |===
 
 .Returns
-A function which will launch a modal for editing a resource's annotations.
+A function which launches a modal for editing a resource's annotations.
 
 [discrete]
 == `useDeleteModal`
@@ -1561,7 +1561,7 @@ const DeletePodButton = ({ pod }) => {
 |===
 
 .Returns
-A function which will launch a modal for deleting a resource.
+A function which launches a modal for deleting a resource.
 
 [discrete]
 == `useLabelsModel`
@@ -1585,7 +1585,7 @@ const PodLabelsButton = ({ pod }) => {
 |===
 
 .Returns
-A function which will launch a modal for editing a resource's labels.
+A function which launches a modal for editing a resource's labels.
 
 [discrete]
 == `useActiveNamespace`

modules/gitops-release-notes-1-4-0.adoc

@@ -24,7 +24,7 @@ The current release adds the following improvements.
 
 * As an administrative user, when you give Argo CD access to a namespace by using the `argocd.argoproj.io/managed-by` label, it assumes namespace-admin privileges. These privileges are an issue for administrators who provide namespaces to non-administrators, such as development teams, because the privileges enable non-administrators to modify objects such as network policies.
 +
-With this update, administrators can configure a common cluster role for all the managed namespaces. In role bindings for the Argo CD application controller, the Operator refers to the `CONTROLLER_CLUSTER_ROLE` environment variable. In role bindings for the Argo CD server, the Operator refers to the `SERVER_CLUSTER_ROLE` environment variable. If these environment variables contain custom roles, the Operator doesn't create the default admin role. Instead, it uses the existing custom role for all managed namespaces. link:https://issues.redhat.com/browse/GITOPS-1290[GITOPS-1290]
+With this update, administrators can configure a common cluster role for all the managed namespaces. In role bindings for the Argo CD application controller, the Operator refers to the `CONTROLLER_CLUSTER_ROLE` environment variable. In role bindings for the Argo CD server, the Operator refers to the `SERVER_CLUSTER_ROLE` environment variable. If these environment variables contain custom roles, the Operator does not create the default admin role. Instead, it uses the existing custom role for all managed namespaces. link:https://issues.redhat.com/browse/GITOPS-1290[GITOPS-1290]
 
 * With this update, the *Environments* page in the {product-title} *Developer* perspective displays a broken heart icon to indicate degraded resources, excluding ones whose status is `Progressing`, `Missing`, and `Unknown`. The console displays a yellow yield sign icon to indicate out-of-sync resources. link:https://issues.redhat.com/browse/GITOPS-1307[GITOPS-1307]
 
@@ -37,9 +37,9 @@ The following issues have been resolved in the current release:
 
 * Before this update, setting a resource quota in the namespace of the Argo CD custom resource might cause the setup of the Red Hat SSO (RH SSO) instance to fail. This update fixes this issue by setting a minimum resource request for the RH SSO deployment pods. link:https://issues.redhat.com/browse/GITOPS-1297[GITOPS-1297]
 
-* Before this update, if you changed the log level for the `argocd-repo-server` workload, the Operator didn't reconcile this setting. The workaround was to delete the deployment resource so that the Operator recreated it with the new log level. With this update, the log level is correctly reconciled for existing `argocd-repo-server` workloads. link:https://issues.redhat.com/browse/GITOPS-1387[GITOPS-1387]
+* Before this update, if you changed the log level for the `argocd-repo-server` workload, the Operator did not reconcile this setting. The workaround was to delete the deployment resource so that the Operator recreated it with the new log level. With this update, the log level is correctly reconciled for existing `argocd-repo-server` workloads. link:https://issues.redhat.com/browse/GITOPS-1387[GITOPS-1387]
 
-* Before this update, if the Operator managed an Argo CD instance that lacked the `.data` field in the `argocd-secret` Secret, the Operator on that instance crashed. This update fixes the issue so that the Operator doesn't crash when the `.data` field is missing. Instead, the secret regenerates and the `gitops-operator-controller-manager` resource is redeployed. link:https://issues.redhat.com/browse/GITOPS-1402[GITOPS-1402]
+* Before this update, if the Operator managed an Argo CD instance that lacked the `.data` field in the `argocd-secret` Secret, the Operator on that instance crashed. This update fixes the issue so that the Operator does not crash when the `.data` field is missing. Instead, the secret regenerates and the `gitops-operator-controller-manager` resource is redeployed. link:https://issues.redhat.com/browse/GITOPS-1402[GITOPS-1402]
 
 * Before this update, the `gitopsservice` service was annotated as an internal object. This update removes the annotation so you can update or delete the default Argo CD instance and run GitOps workloads on infrastructure nodes by using the UI. link:https://issues.redhat.com/browse/GITOPS-1429[GITOPS-1429]