docs: review to make clear the CLI should be use to manage the emulator

Signed-off-by: David Dal Busco <david.dalbusco@outlook.com>

Author: peterpeterparker

docs/guides/local-development.mdx

@@ -1,13 +1,26 @@
 ---
 id: local-development
 title: Local Development
-description: Set-up the local emulator with Docker or Podman
+description: Run a full local development environment with the Juno emulator using Docker or Podman, complete with Console UI, live reload, and smart contract support.
 ---
 
 # Local Development
 
 Juno offers something most platforms don’t: a full local development environment that closely mirrors production.
 
+## TL;DR
+
+| What              | How                                            |
+| ----------------- | ---------------------------------------------- |
+| Runtime supported | Docker or Podman                               |
+| Start emulator    | `juno dev start`                               |
+| Stop emulator     | `juno dev stop`                                |
+| Console UI URL    | [http://localhost:5866](http://localhost:5866) |
+
+---
+
+## What the Emulator Includes
+
 When you develop locally, you're running an emulator that includes the well known infrastructure services — including the actual administration Console UI.
 
 This enables:
@@ -22,9 +35,9 @@ This enables:
 
 ## Before you begin
 
-An emulator — a self-contained local environment that includes services, replicas, and the Console UI — is run using containers. You can use [Docker](https://www.docker.com/) (default) or [Podman](https://podman.io/) as the container runtime.
+The emulator is a self-contained local environment that runs in a container managed entirely by Juno — using either [Docker](https://www.docker.com/) or [Podman](https://podman.io/) under the hood.
 
-Make sure either tool is installed on your machine:
+Make sure your preferred runtime is installed on your machine:
 
 - [Docker: Windows](https://docs.docker.com/desktop/install/windows-install/)
 - [Docker: macOS](https://docs.docker.com/desktop/install/mac-install/)
@@ -43,7 +56,7 @@ For **Podman**, we are not aware of any particular version requirements at this
 
 ## Getting Started
 
-The easiest way to run the local developer environment is through the CLI.
+To run the emulator for local development, you need to have the Juno CLI installed.
 
 If you haven’t installed it yet, run:
 
@@ -67,6 +80,12 @@ To stop the emulator, run:
 juno dev stop
 ```
 
+:::note
+
+While you could technically start the emulator using `docker run` or `podman run`, we recommend using the Juno CLI to manage the emulator lifecycle. It handles important checks, sets the correct configuration, and ensures everything runs as expected.
+
+:::
+
 ---
 
 ## Available Images