ensure async and docs

Author: Carreau

jupyter_server/services/sessions/sessionmanager.py

@@ -279,14 +279,16 @@ async def create_session(
     async def get_kernel_env(self, path: str, name: Optional[str] = None) -> Dict[str, str]:
         """Return the environment variables that need to be set in the kernel
 
+        path : str
+            the path for the given session – seem to be a session id sometime.
         name: str
             Here the name is likely to be the name of the associated file
             with the current kernel at startup time.
 
 
         """
         if name is not None:
-            session_dir = await self.contents_manager.get_kernel_path(path=path)
+            session_dir = await ensure_async(self.contents_manager.get_kernel_path(path=path))
             cwd = self.kernel_manager.cwd_for_path(path)
             path = os.path.join(cwd, session_dir, name)
         assert isinstance(path, str)
@@ -295,9 +297,15 @@ async def get_kernel_env(self, path: str, name: Optional[str] = None) -> Dict[st
     async def start_kernel_for_session(self, session_id, path, name, type, kernel_name):
         """Start a new kernel for a given session.
 
-        name: str
+        session_id : str
+            uuid for the session; this method must be given a session_id
+        path : str
+            the path for the given session – seem to be a session id sometime.
+        name : str
             Usually the model name, like the filename associated with current
             kernel.
+        type : string
+            the type of the session, seem to be unused.
 
         """
         # allow contents manager to specify kernels cwd
@@ -324,9 +332,9 @@ async def save_session(self, session_id, path=None, name=None, type=None, kernel
             uuid for the session; this method must be given a session_id
         path : str
             the path for the given session
-        name: str
+        name : str
             the name of the session
-        type: string
+        type : string
             the type of the session
         kernel_id : str
             a uuid for the kernel associated with this session