mirror of https://github.com/crossplane/docs.git
clarify that plural names should be used in MRAPs
Signed-off-by: Jared Watts <jbw976@gmail.com>
This commit is contained in:
parent
0248bb39c6
commit
622a3c343f
|
|
@ -83,6 +83,13 @@ spec:
|
|||
- clusters.eks.aws.m.crossplane.io
|
||||
```
|
||||
|
||||
{{<hint "important">}}
|
||||
Use the **plural** name when using a complete MRD name, aligning with how
|
||||
Kubernetes expresses the complete names of CRDs.
|
||||
|
||||
For example, use `buckets`, as opposed to `bucket`, in `buckets.s3.aws.m.crossplane.io`.
|
||||
{{</hint>}}
|
||||
|
||||
### Wildcard patterns
|
||||
|
||||
Use `*` wildcards to match multiple resources:
|
||||
|
|
@ -443,8 +450,9 @@ conflicts. This enables team-based activation strategies and Configuration
|
|||
package dependencies.
|
||||
|
||||
<!-- vale alex.ProfanityUnlikely = NO -->
|
||||
1. **Start specific, broaden as needed** - Begin with exact resource names,
|
||||
add wildcards only when beneficial for maintainability
|
||||
1. **Start specific, broaden as needed** - Begin with exact resource names
|
||||
(using the plural name for each resource), add wildcards only when beneficial for
|
||||
maintainability
|
||||
2. **Plan for provider evolution** - Design wildcard patterns that
|
||||
accommodate new resources as providers add them (for example,
|
||||
`*.s3.aws.m.crossplane.io` works for future S3 resources)
|
||||
|
|
|
|||
|
|
@ -83,6 +83,13 @@ spec:
|
|||
- clusters.eks.aws.m.crossplane.io
|
||||
```
|
||||
|
||||
{{<hint "important">}}
|
||||
Use the **plural** name when using a complete MRD name, aligning with how
|
||||
Kubernetes expresses the complete names of CRDs.
|
||||
|
||||
For example, use `buckets`, as opposed to `bucket`, in `buckets.s3.aws.m.crossplane.io`.
|
||||
{{</hint>}}
|
||||
|
||||
### Wildcard patterns
|
||||
|
||||
Use `*` wildcards to match multiple resources:
|
||||
|
|
@ -443,8 +450,9 @@ conflicts. This enables team-based activation strategies and Configuration
|
|||
package dependencies.
|
||||
|
||||
<!-- vale alex.ProfanityUnlikely = NO -->
|
||||
1. **Start specific, broaden as needed** - Begin with exact resource names,
|
||||
add wildcards only when beneficial for maintainability
|
||||
1. **Start specific, broaden as needed** - Begin with exact resource names
|
||||
(using the plural name for each resource), add wildcards only when beneficial for
|
||||
maintainability
|
||||
2. **Plan for provider evolution** - Design wildcard patterns that
|
||||
accommodate new resources as providers add them (for example,
|
||||
`*.s3.aws.m.crossplane.io` works for future S3 resources)
|
||||
|
|
|
|||
Loading…
Reference in New Issue