diff --git a/docs/copy-sync.md b/docs/copy-sync.md
index 0a33e474..ac64807f 100644
--- a/docs/copy-sync.md
+++ b/docs/copy-sync.md
@@ -2,8 +2,8 @@
 
 Copy a file or directory. The directory can have contents. Like `cp -r`.
 
-- `src` `<String>`
-- `dest` `<String>`
+- `src` `<String>` Note that if `src` is a directory it will copy everything inside of this directory, not the entire directory itself (see [issue #537](https://github.com/jprichardson/node-fs-extra/issues/537)).
+- `dest` `<String>` Note that if `src` is a file, `dest` cannot be a directory (see [issue #323](https://github.com/jprichardson/node-fs-extra/issues/323)).
 - `options` `<Object>`
   - `overwrite` `<boolean>`: overwrite existing file or directory, default is `true`. _Note that the copy operation will silently fail if you set this to `false` and the destination exists._ Use the `errorOnExist` option to change this behavior.
   - `errorOnExist` `<boolean>`: when `overwrite` is `false` and the destination exists, throw an error. Default is `false`.
diff --git a/docs/copy.md b/docs/copy.md
index 23fffaf7..d0f78a97 100644
--- a/docs/copy.md
+++ b/docs/copy.md
@@ -2,7 +2,7 @@
 
 Copy a file or directory. The directory can have contents. Like `cp -r`.
 
-- `src` `<String>`
+- `src` `<String>` Note that if `src` is a directory it will copy everything inside of this directory, not the entire directory itself (see [issue #537](https://github.com/jprichardson/node-fs-extra/issues/537)).
 - `dest` `<String>` Note that if `src` is a file, `dest` cannot be a directory (see [issue #323](https://github.com/jprichardson/node-fs-extra/issues/323)).
 - `options` `<Object>`
   - `overwrite` `<boolean>`: overwrite existing file or directory, default is `true`. _Note that the copy operation will silently fail if you set this to `false` and the destination exists._ Use the `errorOnExist` option to change this behavior.