Refactor core developer guide

Author: fabriziopandini

docs/book/src/SUMMARY.md

@@ -67,35 +67,36 @@
     - [clusterctl Provider Contract](clusterctl/provider-contract.md)
     - [clusterctl for Developers](clusterctl/developers.md)
     - [clusterctl Extensions with Plugins](clusterctl/plugins.md)
-- [Developer Guide](./developer/guide.md)
-    - [Repository Layout](./developer/repository-layout.md)
-    - [Rapid iterative development with Tilt](./developer/tilt.md)
-    - [Logging](./developer/logging.md)
-    - [Testing](./developer/testing.md)
-    - [Developing E2E tests](./developer/e2e.md)
-    - [Controllers](./developer/architecture/controllers.md)
-        - [Bootstrap](./developer/architecture/controllers/bootstrap.md)
-        - [Cluster](./developer/architecture/controllers/cluster.md)
-        - [Machine](./developer/architecture/controllers/machine.md)
-        - [MachineSet](./developer/architecture/controllers/machine-set.md)
-        - [MachineDeployment](./developer/architecture/controllers/machine-deployment.md)
-        - [MachineHealthCheck](./developer/architecture/controllers/machine-health-check.md)
-        - [Control Plane](./developer/architecture/controllers/control-plane.md)
-        - [MachinePool](./developer/architecture/controllers/machine-pool.md)
-        - [ClusterTopology](./developer/architecture/controllers/cluster-topology.md)
-        - [ClusterResourceSet](./developer/architecture/controllers/cluster-resource-set.md)
-        - [Multi-tenancy](./developer/architecture/controllers/multi-tenancy.md)
-        - [Support multiple instances](./developer/architecture/controllers/support-multiple-instances.md)
-        - [Tuning controllers](./developer/architecture/controllers/tuning.md)
+- [Developer Guide](./developer/getting-started.md)
+    - [Developing "core" Cluster API](developer/core/overview.md)
+        - [Rapid iterative development with Tilt](developer/core/tilt.md)
+        - [Repository Layout](developer/core/repository-layout.md)
+        - [Controllers](./developer/core/controllers/overview.md)
+          - [Cluster](./developer/core/controllers/cluster.md)
+          - [ClusterTopology](./developer/core/controllers/cluster-topology.md) 
+          - [ClusterResourceSet](./developer/core/controllers/cluster-resource-set.md)
+          - [MachineDeployment](./developer/core/controllers/machine-deployment.md)
+          - [MachineSet](./developer/core/controllers/machine-set.md)  
+          - [Machine](./developer/core/controllers/machine.md)
+          - [MachinePool](./developer/core/controllers/machine-pool.md)
+          - [MachineHealthCheck](./developer/core/controllers/machine-health-check.md)     
+          - [Bootstrap](./developer/core/controllers/bootstrap.md)
+          - [Control Plane](./developer/core/controllers/control-plane.md)
+        - [Logging](developer/core/logging.md)
+        - [Testing](developer/core/testing.md)
+        - [Developing E2E tests](developer/core/e2e.md)
+        - [Tuning controllers](./developer/core/tuning.md) 
+        - [Support multiple instances](./developer/core/support-multiple-instances.md)
+        - [Multi-tenancy](./developer/core/multi-tenancy.md)
     - [Developing providers](./developer/providers/overview.md)
         - [Getting started](developer/providers/getting-started/overview.md)
-            - [Naming](developer/providers/getting-started/naming.md)
-            - [Initialize Repo and API types](developer/providers/getting-started/initialize-repo-and-api-types.md)
-            - [Implement API types](developer/providers/getting-started/implement-api-types.md)
-            - [Webhooks](developer/providers/getting-started/webhooks.md)
-            - [Controllers and Reconciliation](developer/providers/getting-started/controllers-and-reconciliation.md)
-            - [Configure the provider manifest](developer/providers/getting-started/configure-the-deployment.md)
-            - [Building, Running, Testing](developer/providers/getting-started/building-running-and-testing.md)
+          - [Naming](developer/providers/getting-started/naming.md)
+          - [Initialize Repo and API types](developer/providers/getting-started/initialize-repo-and-api-types.md)
+          - [Implement API types](developer/providers/getting-started/implement-api-types.md)
+          - [Webhooks](developer/providers/getting-started/webhooks.md)
+          - [Controllers and Reconciliation](developer/providers/getting-started/controllers-and-reconciliation.md)
+          - [Configure the provider manifest](developer/providers/getting-started/configure-the-deployment.md)
+          - [Building, Running, Testing](developer/providers/getting-started/building-running-and-testing.md)
         - [Provider contracts](./developer/providers/contracts.md)
           - [Cluster Infrastructure](./developer/providers/cluster-infrastructure.md)
           - [Control Plane](./developer/providers/control-plane.md)

docs/book/src/clusterctl/provider-contract.md

@@ -254,7 +254,7 @@ While defining the Deployment Spec, the container that executes the controller/r
 
 For controllers only, the manager MUST support a `--namespace` flag for specifying the namespace where the controller
 will look for objects to reconcile; however, clusterctl will always install providers watching for all namespaces
-(`--namespace=""`); for more details see [support for multiple instances](../developer/architecture/controllers/support-multiple-instances.md)
+(`--namespace=""`); for more details see [support for multiple instances](../developer/core/support-multiple-instances.md)
 for more context.
 
 While defining Pods for Deployments, canonical names should be used for images.

docs/book/src/developer/architecture/controllers.md

@@ -1,6 +1,6 @@
 # MachineDeployment
 
-A MachineDeployment orchestrates deployments over a fleet of [MachineSets](./machine-set.md).
+A MachineDeployment orchestrates deployments over a fleet of MachineSets.
 
 Its main responsibilities are:
 * Adopting matching MachineSets not assigned to a MachineDeployment

docs/book/src/developer/architecture/controllers/bootstrap.md renamed to docs/book/src/developer/core/controllers/bootstrap.md

@@ -1,6 +1,6 @@
 # MachineHealthCheck
 
-A MachineHealthCheck is responsible for remediating unhealthy [Machines](./machine.md).
+A MachineHealthCheck is responsible for remediating unhealthy Machines.
 
 Its main responsibilities are:
 * Checking the health of Nodes in the [workload clusters] against a list of unhealthy conditions