docs: Clarify what changed in minimal subscribe example between versi…

…ons; #266

docs/introduction.md

@@ -4,6 +4,4 @@ This documentation aims to cover everything you need to know to use aiomqtt in y
 
 If you're new to MQTT, we recommend reading the [HiveMQ MQTT essentials](https://www.hivemq.com/mqtt-essentials/) guide as an introduction. Afterward, the [OASIS specification](https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) is a great reference. For asyncio, we recommend the [RealPython asyncio walkthrough](https://realpython.com/async-io-python/) as an introduction and the [asyncio docs](https://docs.python.org/3/library/asyncio.html) as a reference.
 
-You're a big help if you open an issue or a pull request when you find an error or when you have an idea of how to improve these docs. It's easy to miss things that are unclear to newcomers when you're already familiar with the project. We need your fresh eyes here!
-
-That said, let's dive in! 🤿
+Thanks for being part of our community! ☀️

docs/migration-guide-v2.md

@@ -55,7 +55,25 @@ asyncio.run(main())
 
 The `filtered_messages`, `unfiltered_messages`, and `messages` methods have been removed and replaced with a single client-wide message queue.
 
-A minimal example of printing all messages (unfiltered) looks like this:
+For previous versions, a minimal example of printing all messages (unfiltered) looked like this:
+
+```python
+import asyncio
+import aiomqtt
+
+
+async def main():
+    async with aiomqtt.Client("test.mosquitto.org") as client:
+        await client.subscribe("temperature/#")
+        async with client.messages() as messages:
+            async for message in messages:
+                print(message.payload)
+
+
+asyncio.run(main())
+```
+
+We now no longer need the line `async with client.messages() as messages:`, but instead access the message generator directly with `client.messages`:
 
 ```python
 import asyncio

docs/subscribing-to-a-topic.md

@@ -184,7 +184,7 @@ asyncio.run(main())
 ```
 
 ```{tip}
-You can combine this idea with the one [from the previous section](#the-message-queue) to e.g. handle temperature in FIFO and humidity in LIFO order.
+You can use [different queue types](#the-message-queue) for these queues to e.g. handle temperature in FIFO and humidity in LIFO order.
 ```
 
 ## Listening without blocking