Add comprehensive documentation for resource extension points#5004

Copilot wants to merge 11 commits intomainAzure/azure-service-operator:mainfrom

copilot/add-docs-for-extension-pointsAzure/azure-service-operator:copilot/add-docs-for-extension-pointsCopy head branch name to clipboard