fixup! EDU-1469: Re-writes idempotent publishing section to improve clarity to the reader

Author: franrob-projects

Diff for: content/channels/index.textile

@@ -771,7 +771,6 @@ In these cases, you can manually specify the message ID for REST and realtime pu
 
 The following example manually specifies a message ID:
 
-
 ```[realtime_javascript]
 const realtime = new Ably.Realtime = '{{API_KEY}}';
 const channel = realtime.channels.get('{{RANDOM_CHANNEL_NAME}}');
@@ -826,9 +825,9 @@ ARTRealtimeChannel *channel = [realtime.channels get:("{{RANDOM_CHANNEL_NAME}}")
 
 ```[realtime_flutter]
 final clientOptions = ably.ClientOptions(key: '{{API_KEY}}');
-final rest = ably.Realtime(options: clientOptions);
+final realtime = ably.Realtime(options: clientOptions);
 final channel = realtime.channels.get('{{RANDOM_CHANNEL_NAME}}');
-final message = ably.Message(data: 'payload', id: 'unique123');
+await message = ably.Message(data: 'payload', id: 'unique123');
 ```
 
 ```[realtime_go]
@@ -870,7 +869,7 @@ channel = rest.channels.get('{{RANDOM_CHANNEL_NAME}}')
 await channel.publish([{data: 'payload', id: 'unique123'}])
 ```
 
-```[rest_PHP]
+```[rest_php]
 $rest = new Ably\AblyRest('{{API_KEY}}');
 $channel = $rest->channels->get('{{RANDOM_CHANNEL_NAME}}')
 $channel->publish([{data: 'payload', id: 'unique123'}]);
@@ -895,7 +894,7 @@ channel publish:@"example" data:@"payload" id:@"unique123" callback:^(ARTErrorIn
 ```[rest_swift]
 let rest = ARTRest(key: "{{API_KEY}}")
 var channel = rest.channels.get("{{RANDOM_CHANNEL_NAME}}")
-channel.publish([ARTMessage(name: "example", data: "message data", id: "unique123")])
+channel.publish("example", data: "message data", id: "unique123")
 ```
 
 ```[rest_objc]
@@ -908,7 +907,7 @@ ARTRestChannel *channel = [rest.channels get:("{{RANDOM_CHANNEL_NAME}}");
 final clientOptions = ably.ClientOptions(key: '{{API_KEY}}');
 final rest = ably.Rest(options: clientOptions);
 final channel = rest.channels.get('{{RANDOM_CHANNEL_NAME}}');
-final message = ably.Message(data: 'payload', id: 'unique123');
+await message = ably.Message(data: 'payload', id: 'unique123');
 ```
 
 ```[rest_go]
@@ -928,7 +927,7 @@ message := &ably.Message{
 
 h4. Restrictions and considerations
 
-When specifying custom message IDs, particularly when attempting to "publish()":/api/rest-sdk/channels#publish multiple messages atomically with idempotency, ensure that the IDs adhere to the format restrictions. For more details on these restrictions, refer to the "FAQ":https://faqs.ably.com/client-specified-message-id-restrictions-for-multiple-messages-published-atomically.
+When specifying custom message IDs, particularly when attempting to "@publish()@":/api/rest-sdk/channels#publish multiple messages atomically with idempotency, ensure that the IDs adhere to the format restrictions. For more details on these restrictions, refer to the "FAQ":https://faqs.ably.com/client-specified-message-id-restrictions-for-multiple-messages-published-atomically.
 
 h3(#publish-on-behalf). Use the REST interface to publish on behalf of a realtime connection