From 551a9183fba7375fb54ac02e3a551f0f9f3e0f92 Mon Sep 17 00:00:00 2001
From: Myles Braithwaite <myles@monkeyinyoursoul.com>
Date: Wed, 14 Nov 2018 08:58:15 -0500
Subject: [PATCH] DOC: Accessing files from a S3 bucket. (#23639)

---
 doc/source/io.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/source/io.rst b/doc/source/io.rst
index 34dc185c200e63..92fc28af0281a9 100644
--- a/doc/source/io.rst
+++ b/doc/source/io.rst
@@ -1580,12 +1580,19 @@ You can pass in a URL to a CSV file:
    df = pd.read_csv('https://download.bls.gov/pub/time.series/cu/cu.item',
                     sep='\t')
 
-S3 URLs are handled as well:
+S3 URLs are handled as well but require installing the `S3Fs
+<https://pypi.org/project/s3fs/>`_ library:
 
 .. code-block:: python
 
    df = pd.read_csv('s3://pandas-test/tips.csv')
 
+If your S3 bucket requires cedentials you will need to set them as environment
+variables or in the ``~/.aws/credentials`` config file, refer to the `S3Fs
+documentation on credentials
+<https://s3fs.readthedocs.io/en/latest/#credentials>`_.
+
+
 
 Writing out Data
 ''''''''''''''''