diff --git a/doc/source/contributors/layout.rst b/doc/source/contributors/layout.rst
index edeac05c..e7f11102 100644
--- a/doc/source/contributors/layout.rst
+++ b/doc/source/contributors/layout.rst
@@ -9,7 +9,7 @@ Session
 -------
 
 The :class:`openstack.session.Session` manages an authenticator,
-transport, and user preferences. It exposes methods corresponding to
+transport, and user profile. It exposes methods corresponding to
 HTTP verbs, and injects your authentication token into a request,
 determines any service preferences callers may have set, gets the endpoint
 from the authenticator, and sends the request out through the transport.
diff --git a/doc/source/users/index.rst b/doc/source/users/index.rst
index e8232eac..6d589dca 100644
--- a/doc/source/users/index.rst
+++ b/doc/source/users/index.rst
@@ -50,7 +50,7 @@ Connection Interface
 ********************
 
 A *Connection* instance maintains your session, authentication, transport,
-and preferences, providing you with a set of higher-level interfaces to work
+and profile, providing you with a set of higher-level interfaces to work
 with OpenStack services.
 
 .. toctree::
@@ -60,7 +60,7 @@ with OpenStack services.
    profile
 
 Once you have a *Connection* instance, the following services may be exposed
-to you. Your user preferences determine the full set of exposed services,
+to you. Your user profile determine the full set of exposed services,
 but listed below are the ones provided by this SDK by default.
 
 .. toctree::
diff --git a/doc/source/users/userguides/usage.rst b/doc/source/users/userguides/usage.rst
index 62490956..b425381a 100644
--- a/doc/source/users/userguides/usage.rst
+++ b/doc/source/users/userguides/usage.rst
@@ -10,7 +10,7 @@ To use python-openstacksdk in a project::
     from openstack import connection
     from openstack import profile
 
-    # First, specify your preferences
+    # First, specify your profile
     prof = profile.Profile()
     prof.set_region('network', 'zion')
 
@@ -23,7 +23,7 @@ To use python-openstacksdk in a project::
     }
 
     # Third, create a connection
-    conn = connection.Connection(preference=prof, **auth_args)
+    conn = connection.Connection(profile=prof, **auth_args)
 
     # Finally, access your desired services
     network = conn.network.find_network("matrix")