diff --git a/docs/book/src/faq.md b/docs/book/src/faq.md index 259fa425be8..96f333d25b3 100644 --- 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.