@@ -4,7 +4,7 @@ Simplified Builder-Based Scaffolding
4
4
## Background
5
5
6
6
The current scaffolding in kubebuilder produces a directory structure that
7
- looks something like this (compiled artificacts like config omitted for
7
+ looks something like this (compiled artifacts like config omitted for
8
8
brevity):
9
9
10
10
<details >
@@ -114,7 +114,7 @@ files, 6 are KubeBuilder-specific glue code, 4 are test setup, and
114
114
user-edited code.
115
115
116
116
This proliferation of files makes it difficult for users to understand how
117
- their code relates to the library, posing some barier for initial adoption
117
+ their code relates to the library, posing some barrier for initial adoption
118
118
and moving beyond a basic knowledge of functionality to actual
119
119
understanding of the structure. A common line of questioning amongst
120
120
newcomers to KubeBuilder includes "where should I put my code that adds
@@ -179,7 +179,7 @@ Users receive a simply scaffolded structure to start. Simple projects can
179
179
remain relatively simple, and complicated projects can decide to adopt
180
180
a different structure as they grow.
181
181
182
- The new scaffoled project structure looks something like this (compiled
182
+ The new scaffold project structure looks something like this (compiled
183
183
artifacts like config omitted for brevity):
184
184
185
185
``` shell
@@ -223,7 +223,7 @@ func (r *myReconciler) SetupWithManager(mgr ctrl.Manager) error {
223
223
```
224
224
225
225
This makes it abundantly clear where to start looking at the code
226
- (` main.go ` is the defacto standard entrypoint for many go programs), and
226
+ (` main.go ` is the defacto standard entry-point for many go programs), and
227
227
simplifies the levels of hierarchy. Furthermore, since ` main.go ` actually
228
228
instantiates an instance of the reconciler, users are able to add custom
229
229
logic having to do with flags.
@@ -248,7 +248,7 @@ easy to setup with a manager.
248
248
249
249
These suggestions make it much harder to scaffold out additional versions
250
250
and kinds. You need to have each version in a separate package, so that
251
- type names don't confict . While we could put scheme registration in with
251
+ type names don't conflict . While we could put scheme registration in with
252
252
` kind_types.go ` , if a project has multiple "significant" Kinds in an API
253
253
group, it's not immediately clear which file has the scheme registration.
254
254
@@ -323,7 +323,7 @@ scaffold out the builder. We have two options here:
323
323
324
324
2 . Simply adding a new controller, and reminding the user to add the
325
325
builder themselves. This is easier for the maintainers, but perhaps
326
- a slighly poorer UX for the users. However, writing out a builder by
326
+ a slightly poorer UX for the users. However, writing out a builder by
327
327
hand is significantly less complex than adding a controller by hand in
328
328
the current structure.
329
329
@@ -348,7 +348,7 @@ versions, controllers, etc
348
348
### Teaching more complicated project structures
349
349
350
350
Some controllers may eventually want more complicated project structures.
351
- We should have a section of the book reccomending options for when you
351
+ We should have a section of the book recommending options for when you
352
352
project gets very complicated.
353
353
354
354
### Additional Tooling Work
0 commit comments