docs: improve container web server doc (#1122)

rework doc structure
streamline the prose

Author: TC-MO

sources/platform/actors/development/programming_interface/container_web_server.md

@@ -5,26 +5,40 @@ slug: /actors/development/programming-interface/container-web-server
 sidebar_position: 7
 ---
 
-**Learn about how to run a web server inside your Actor, which enables you to communicate with the outer world via both UI and API.**
+**Learn about how to run a web server inside your Actor to enable communication with the outside world through both UI and API.**
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
 ---
 
-Each Actor run is assigned a unique hard-to-guess URL (e.g. `kmdo7wpzlshygi.runs.apify.net`), which enables HTTP access to an optional web server running inside the Actor run's Docker container. The URL is available in the following places:
+Each Actor run is assigned a unique URL (e.g. `kmdo7wpzlshygi.runs.apify.net`) that allows HTTP access to an optional web server running inside the Actor's Docker container. This feature enhances your Actor's capabilities by enabling external communication.
+
+## Access the container URL
+
+You can find the container URL in three locations:
 
 - In the web application, on the Actor run details page as the **Container URL** field.
 - In the API as the `containerUrl` property of the [Run object](/api/v2#/reference/actors/run-object/get-run).
 - In the Actor run's container as the `ACTOR_WEB_SERVER_URL` environment variable.
 
-The web server running inside the container must listen at the port defined by the `ACTOR_WEB_SERVER_PORT` environment variable (typically 4321). If you want to use another port, simply define the `ACTOR_WEB_SERVER_PORT` environment variable with the desired port number in your Actor version configuration - see [Custom environment variables](./environment_variables.md) for details.
+## Set up the web server
+
+The web server inside the container must listen on the port specified by the `ACTOR_WEB_SERVER_PORT` environment variable (typically: _4321_). To use a different port:
+
+1. Go to your Actor version configuration
 
-The following example demonstrates how to start a simple web server in your Actor:
+1. Define the `ACTOR_WEB_SERVER_PORT` environment variable with your desired port number.
+
+Check out [Custom environment variables](./environment_variables.md) for more details.
+
+## Example: Start a simple web server
 
 <Tabs groupId="main">
 <TabItem value="JavaScript" label="JavaScript">
 
+Here's how to start a basic web server in your Actor using Express.js:
+
 ```js
 // npm install express
 import { Actor } from 'apify';
@@ -52,6 +66,8 @@ await Actor.exit();
 </TabItem>
 <TabItem value="Python" label="Python">
 
+Here's how to start a basic web server in your Actor using Flask:
+
 ```python
 # pip install flask
 import asyncio