Update docs/book/src/faq.md

Co-authored-by: Camila Macedo <7708031+camilamacedo86@users.noreply.github.com>
Sajiyah-Salat · Sep 11, 2023 · b389b9e · b389b9e
1 parent 075b836
commit b389b9e
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/docs/book/src/faq.md b/docs/book/src/faq.md
@@ -114,7 +114,9 @@ Your CRDs are generated using [controller-gen][controller-gen]. By using the opt
      # However, it has a size limit and if the CRD is too big with so many long descriptions as this one it will cause the failure. 
  	$(CONTROLLER_GEN) rbac:roleName=manager-role crd:maxDescLen=0 webhook paths="./..." output:crd:artifacts:config=config/crd/bases 
 ``` 	
-You can review the design of your APIs and see if it has not more specs than should be by hurting single responsibility principle for example. So that you might to re-design them.
+**By reviewing and refactoring the API/CRD Design
+
+Examine your APIs to ensure they're designed with a clear focus and aren't overly complex. Overcomplicated designs can violate principles like the [Single Responsibility][single-responsability] Principle, making the CRD overly bulky.