refactoring docstring

jedi/refactoring.py

@@ -1,4 +1,16 @@
-""" Introduce refactoring """
+"""
+Introduce some basic refactoring functions to |jedi|. This module is still in a
+very early development stage and needs much testing and improvement.
+
+It uses the |jedi| `API <plugin-api.html>`_ and supports currently the
+following functions (sometimes bug-prone):
+
+- rename
+- extract variable
+- inline variable
+
+**I won't do too much here, but if anyone wants to step in, please do.**
+"""
 
 from __future__ import with_statement