From 0ffc066f16802e1d99e93381e131c99a23fab2bb Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 29 Aug 2022 20:46:23 +0000
Subject: [PATCH] Update docs

---
 contracts/token/ERC721/IERC721.sol       | 4 +++-
 docs/modules/api/pages/token/ERC721.adoc | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/contracts/token/ERC721/IERC721.sol b/contracts/token/ERC721/IERC721.sol
index 4bb973b3e..46f73b4ef 100644
--- a/contracts/token/ERC721/IERC721.sol
+++ b/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:
      *
diff --git a/docs/modules/api/pages/token/ERC721.adoc b/docs/modules/api/pages/token/ERC721.adoc
index 8aa3e9790..4af3c17ad 100644
--- a/docs/modules/api/pages/token/ERC721.adoc
+++ b/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: