Updates container lifecycle docs (#30212)

Author: mikenomitch

src/content/docs/containers/examples/status-hooks.mdx

@@ -12,7 +12,7 @@ products:
 ---
 
 When a Container starts, stops, becomes idle, and errors, it can trigger code execution in a Worker
-that has defined status hooks on the `Container` class. Refer to the [Container package docs](https://github.com/cloudflare/containers/blob/main/README.md#lifecycle-hooks) for more details.
+that has defined status hooks on the `Container` class. Refer to the [Container class lifecycle hooks](/containers/container-class/#lifecycle-hooks) for more details.
 
 ```ts
 import { Container } from "@cloudflare/containers";

src/content/docs/containers/platform-details/architecture.mdx

@@ -92,16 +92,30 @@ should be built for the `linux/amd64` architecture, and should stay within
 
 ### Container shutdown
 
-If you do not set [`sleepAfter`](https://github.com/cloudflare/containers/blob/main/README.md#properties)
+If you do not set [`sleepAfter`](/containers/container-class/#sleepafter)
 on your Container class, or stop the instance manually, the container will shut down soon after the container stops receiving requests.
 By setting `sleepAfter`, the container will stay alive for approximately the specified duration.
 
-You can manually shut down a container instance by calling `stop()` or `destroy()` on it. Refer to the [Container package docs](https://github.com/cloudflare/containers/blob/main/README.md#container-methods) for more details.
+You can manually shut down a container instance by calling [`stop()`](/containers/container-class/#stop) or [`destroy()`](/containers/container-class/#destroy) on it.
 
 When a container instance is going to be shut down, it is sent a `SIGTERM` signal,
 and then a `SIGKILL` signal after 15 minutes. You should perform any necessary
 cleanup to ensure a graceful shutdown in this time.
 
+### Lifecycle hooks
+
+The [`Container` class](/containers/container-class/) provides hooks that run Worker code when the container changes state:
+
+- [`onStart()`](/containers/container-class/#onstart) — Runs after the container has started.
+
+- [`onStop()`](/containers/container-class/#onstop) — Runs after the container process exits. Receives the exit code and reason for the stop.
+
+- [`onActivityExpired()`](/containers/container-class/#onactivityexpired) — Runs when the [`sleepAfter`](/containers/container-class/#sleepafter) timer expires with no incoming requests. The default implementation calls `stop()` to shut down the container. You can use this to only stop the container on certain conditions.
+
+- [`onError()`](/containers/container-class/#onerror) — Runs when the container exits with an error.
+
+Refer to the [status hooks example](/containers/examples/status-hooks/) for a full implementation.
+
 #### Persistent disk
 
 All disk is ephemeral. When a Container instance goes to sleep, the next time