Update docs

contracts/token/ERC721/IERC721.sol

@@ -81,7 +81,9 @@ interface IERC721 is IERC165 {
     /**
      * @dev Transfers `tokenId` token from `from` to `to`.
      *
-     * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
+     * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
+     * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
+     * understand this adds an external call which potentially creates a reentrancy vulnerability.
      *
      * Requirements:
      *

docs/modules/api/pages/token/ERC721.adoc

@@ -2487,7 +2487,9 @@ Emits a {Transfer} event.
 
 Transfers `tokenId` token from `from` to `to`.
 
-WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible.
+WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
+or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
+understand this adds an external call which potentially creates a reentrancy vulnerability.
 
 Requirements: