more typing work

docs/conf.py

@@ -594,10 +594,10 @@ def write_conf_docs(app, all_kitten_names):
 def setup(app):
     os.makedirs('generated/conf', exist_ok=True)
     from kittens.runner import all_kitten_names
-    all_kitten_names = all_kitten_names()
-    write_cli_docs(all_kitten_names)
+    kn = all_kitten_names()
+    write_cli_docs(kn)
     write_remote_control_protocol_docs()
-    write_conf_docs(app, all_kitten_names)
+    write_conf_docs(app, kn)
     app.add_lexer('session', SessionLexer())
     app.add_role('link', link_role)
     app.add_role('iss', partial(num_role, 'issues'))

docs/kittens/custom.rst

@@ -20,7 +20,7 @@ your machine).
 
 .. code-block:: python
 
-   def main(args):
+   def main(args: List[str]) -> str:
       # this is the main entry point of the kitten, it will be executed in
       # the overlay window when the kitten is launched
       answer = input('Enter some text: ')
@@ -28,7 +28,7 @@ your machine).
       # handle_result() function
       return answer
 
-   def handle_result(args, answer, target_window_id, boss):
+   def handle_result(args: List[str], answer: str, target_window_id: int, boss: kitty.boss.Boss) -> None:
       # get the kitty window into which to paste answer
       w = boss.window_id_map.get(target_window_id)
       if w is not None: