git commit: docs: Add a note about the extension methods to the FAQ.

[to...@apache.org]

Updated Branches:
  refs/heads/trunk 4750c7fab -> d21c63151


docs: Add a note about the extension methods to the FAQ.


Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo
Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/d21c6315
Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/d21c6315
Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/d21c6315

Branch: refs/heads/trunk
Commit: d21c631519720ee168de75e618a259c6653d1471
Parents: 4750c7f
Author: Tomaz Muraus <to...@apache.org>
Authored: Mon Aug 12 22:55:27 2013 +0200
Committer: Tomaz Muraus <to...@apache.org>
Committed: Mon Aug 12 22:55:27 2013 +0200

----------------------------------------------------------------------
 docs/faq.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/libcloud/blob/d21c6315/docs/faq.rst
----------------------------------------------------------------------
diff --git a/docs/faq.rst b/docs/faq.rst
index 09b6c37..ba5f898 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -11,6 +11,25 @@ that you can't manage block storage independent of the compute API.
 This also makes sense because in most cases you are only interested in attaching
 or detaching volumes from and to the compute nodes.
 
+What are the extension methods?
+-------------------------------
+
+Libcloud acts as a lowest common denominator and exposes a unified base API
+which allows you to work with many different cloud providers through a single
+code base.
+
+Being a lowest common denominator by definition means that not all of the
+functionality offered by different cloud service providers is available
+through a base API.
+
+Libcloud solves this problem and allows user to access provider specific
+functionality through so called extension methods. Extension methods are
+all the methods which are prefixed with the ``ex_``.
+
+Extension methods are there for your convenience, but you should be careful
+when you use them because they make switching or working with multiple
+providers harder.
+
 I want do add a new provider driver what should I do?
 -----------------------------------------------------