fixup! Update docs

Author: matheusaaguiar

docs/assembly.rst

@@ -384,7 +384,7 @@ of Solidity, you can use a special comment to annotate an assembly block as memo
 .. warning::
     The ``memory-safe-assembly`` special comment is deprecated and scheduled for
     removal in the next breaking version (0.9).
-    For new code targeting recent compilers, prefer specifying the dialect string.
+    For new code targeting recent compilers, prefer specifying the assembly block annotation.
 
 Advanced Safe Use of Memory
 ---------------------------

docs/contracts/functions.rst

@@ -310,6 +310,11 @@ will consume more gas than the 2300 gas stipend:
 - Calling an external function which consumes a large amount of gas
 - Sending Ether
 
+.. warning::
+    Note that ``send`` and ``transfer`` are deprecated and scheduled for removal in the next breaking version (0.9).
+    You are encouraged to use the :ref:`call function <address_related>` with an optionally provided maximum
+    amount of gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+
 .. warning::
     When Ether is sent directly to a contract (without a function call, i.e. sender uses ``send`` or ``transfer``)
     but the receiving contract does not define a receive Ether function or a payable fallback function,
@@ -319,11 +324,6 @@ will consume more gas than the 2300 gas stipend:
     not recommended, since the fallback is invoked and would not fail for interface confusions
     on the part of the sender).
 
-.. warning::
-    Note that ``send`` and ``transfer`` are deprecated and scheduled for removal in the next breaking version (0.9).
-    You are encouraged to use the :ref:`call function <address_related>` with an optionally provided maximum
-    amount of gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
-
 .. warning::
     A contract without a receive Ether function can receive Ether as a
     recipient of a *coinbase transaction* (aka *miner block reward*)