Reword

Author: javiereguiluz

components/finder.rst

@@ -127,9 +127,29 @@ If you want to follow `symbolic links`_, use the ``followLinks()`` method::
 
     $finder->files()->followLinks();
 
-.. note::
-
-    Be careful, the ``followLinks`` method does not resolve links. This method makes the links to directories followed/traversed into. If we suppose a folder *followLinksFolder* which contains a folder with a file and a symlink of the folder *folder, file.txt and symlinkfolder*, thanks to the Finder component ``$finder->in('/home/user/followLinksFolder');`` will retrieve three elements *folder, folder/file.txt and symlinkfolder*. If, we use the ``followLinks`` method instead ``$finder->followLinks()->in('/home/user/followLinksFolder');``, we will retrieve also a fourth element *folder, folder/file.txt, symlinkfolder and symlinkfolder/file.txt*.
+Note that this method follows links but it doesn't resolve them. Consider
+the following structure of files of directories:
+
+.. code-block:: text
+
+    ├── folder1/
+    │   ├──file1.txt
+    │   ├── file2link (symbolic link to folder2/file2.txt file)
+    │   └── folder3link (symbolic link to folder3/ directory)
+    ├── folder2/
+    │   └── file2.txt
+    └── folder3/
+        └── file3.txt
+
+If you try to find all files in ``folder1/`` via ``$finder->files()->in('/path/to/folder1/')``
+you'll get the following results:
+
+* When **not** using the ``followLinks()`` method: ``file1.txt`` and ``file2link``
+  (this link is not resolved). The ``folder3link`` doesn't appear in the results
+  because it's not followed or resolved;
+* When using the ``followLinks()`` method: ``file1.txt``, ``file2link`` (this link
+  is still not resolved) and ``folder3/file3.txt`` (this file appears in the results
+  because the ``folder1/folder3link`` link was followed).
 
 Version Control Files
 ~~~~~~~~~~~~~~~~~~~~~