diff --git a/jedi/api/classes.py b/jedi/api/classes.py
index 399755b4..ef26c2ba 100644
--- a/jedi/api/classes.py
+++ b/jedi/api/classes.py
@@ -596,5 +596,12 @@ class CallDef(object):
 
 
 class Param(Definition):
+    """
+    Params are basically a definition for call signatures.
+    """
     def get_code(self):
+        """
+        A function to get the whole code of the param. We might deprecate this
+        function in the future, use :attr:`.description` instead.
+        """
         return self._definition.get_code()