Small text corrections (#11)

* Small text corrections
* typos in drawings

---------

Co-authored-by: Moshe Sambol <[email protected]>
Co-authored-by: Leonid Podolinskiy <[email protected]>

Author: mjsambol

docs/how.md

@@ -1,18 +1,20 @@
 ### How it works
 
- - User creating custom resource of `Kind: LightrunJavaAgent`  
+ - The User begins by creating a custom resource of `Kind: LightrunJavaAgent`  
   [Example](../config/samples/agents_v1beta_lightrunjavaagent.yaml)  
   [Detailed explanation of CR fields](custom_resource.md)
- - Controller is receiving all updates about all CRs(custom resources)`LightrunJavaAgent` across all the cluster (or specific namespaces). Every event triggering reconcile loop of the controller. You can find logic of this loop [here](reconcile_loop.excalidraw.png)  
- - When triggered it is doing several actions:
+ - The Controller receives all updates about all CRs (custom resources) of kind `LightrunJavaAgent` across all the cluster or specific namespaces
+   (subject to how it's been installed). 
+ Every event related to these CRs triggers the reconcile loop of the controller. You can find logic of this loop [here](reconcile_loop.excalidraw.png)  
+ - When triggered, the controller performs several actions:
    - Check if it has access to deployment
-   - Fetch data from the specified in CR secret
+   - Fetch data from the CR secret
    - Create config map with agent config from CR data
-   - Patching deployment:
+   - Patch the deployment:
      - insert init container
      - add volume
-     - map that volume to specified container
-     - add/update specified ENV variable in order to let Java know where agent is placed
- - After deployment is being patched, k8s will `recreate all the pods` in the deployment. New Pods will be using Lightrun agent from their start
- - If user deleting `LightrunJavaAgent` CR, controller will rollback all the changes to deployment. This will trigger `recreation of all pods` again
+     - map that volume to the specified container
+     - add/update specified ENV variable in order to let Java know where agent files are found (the mapped volume)
+ - After deployment is patched, k8s will `recreate all the pods` in the deployment. New Pods will be initialized with the Lightrun agent
+ - If user deletes the `LightrunJavaAgent` CR, the Controller will roll back all the changes to deployment. This will trigger `recreation of all pods` again
  - [High level diagram](resource_relations.excalidraw.png) of resources created/edited by the operator