Merge pull request #1794 from camilamacedo86/cleanup-docs

📖 cleanup / remove hello world

Author: k8s-ci-robot

README.md

@@ -5,15 +5,21 @@
 
 Kubebuilder is a framework for building Kubernetes APIs using [custom resource definitions (CRDs)](https://kubernetes.io/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions).
 
+Similar to web development frameworks such as *Ruby on Rails* and *SpringBoot*,
+Kubebuilder increases velocity and reduces the complexity managed by
+developers for rapidly building and publishing Kubernetes APIs in Go.
+It builds on top of the canonical techniques used to build the core Kubernetes APIs to provide simple abstractions that reduce boilerplate and toil.
+
 **Note:** kubebuilder does not exist as an example to *copy-paste*, but instead provides powerful libraries and tools
 to simplify building and publishing Kubernetes APIs from scratch.
 
+Kubebuilder is developed on top of the controller-runtime and controller-tools libraries.
+
 ### Installation
 
 It is strongly recommended that you use a released version. Release binaries are available on the [releases](https://github.com/kubernetes-sigs/kubebuilder/releases) page.
 Follow the [instructions](https://book.kubebuilder.io/quick-start.html#installation) to install Kubebuilder.
 
-
 ## Getting Started
 
 See the [Getting Started](https://book.kubebuilder.io/quick-start.html) documentation.

docs/book/getting_started/hello_world.md

@@ -39,6 +39,30 @@ Including:
     - How to use Declarative vs Webhook Validation
     - How to implement API versioning
 
+## Why Kubernetes APIs
+
+Kubernetes APIs provide consistent and well defined endpoints for
+objects adhering to a consistent and rich structure.
+
+This approach has fostered a rich ecosystem of tools and libraries for working
+with Kubernetes APIs.
+
+Users work with the APIs through declaring objects as *yaml* or *json* config, and using
+common tooling to manage the objects.
+
+Building services as Kubernetes APIs provides many advantages to plain old REST, including:
+
+* Hosted API endpoints, storage, and validation.
+* Rich tooling and clis such as `kubectl` and `kustomize`.
+* Support for Authn and granular Authz.
+* Support for API evolution through API versioning and conversion.
+* Facilitation of adaptive / self-healing APIs that continuously respond to changes
+  in the system state without user intervention.
+* Kubernetes as a hosting environment
+
+Developers may build and publish their own Kubernetes APIs for installation into
+running Kubernetes clusters.
+
 ## Contribution
 
 If you like to contribute to either this book or the code, please be so kind