[GitHub] [apisix-ingress-controller] juzhiyuan commented on a diff in pull request #1548: docs: update synchronization status check docs

[GitBox <gi...@apache.org>]

juzhiyuan commented on code in PR #1548:
URL: https://github.com/apache/apisix-ingress-controller/pull/1548#discussion_r1054013523


##########
docs/en/latest/tutorials/check-crd-status.md:
##########
@@ -21,28 +27,17 @@ title: How to quickly check the synchronization status of CRD
 #
 -->
 
-When using the Apache APISIX Ingress Controller declarative configuration, often use the `kubectl apply` command. Only if the configuration was verified by its [Open API V3 Schema definition](https://swagger.io/specification/) and its validation webhooks (if any), can the configuration be accepted by Kubernetes.
-
-When the Apache APISIX Ingress Controller watches the resource change, the logic unit of the Apache APISIX Ingress Controller has just started to work.
-In various operations of the Apache APISIX Ingress Controller, object conversion and more verification will be performed.
-When the verification fails, the Apache APISIX Ingress Controller will log an error message and will continue to retry until the declared state is successfully synchronized to APISIX.
-
-Therefore, after the declarative configuration is accepted by Kubernetes, it does not mean that the configuration is synchronized to APISIX.
-
-In this practice, we will show how to check the status of CRD.
-
-## Prerequisites
+APISIX CRDs are applied to a Kubernetes cluster using the `kubectl apply` command. Behind the scenes, Kubernetes verifies the configuration using the [Open API V3 schema](https://swagger.io/specification/) and its validation webhooks (if any).

Review Comment:
   ```suggestion
   APISIX CRDs are applied to a Kubernetes cluster using the `kubectl apply` command. Behind the scenes, Kubernetes verifies the configuration using the [OpenAPI V3 schema](https://swagger.io/specification/) and its validation webhooks (if any).
   ```



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org