Note "How to structure your program"

sphinx/notes-ja.rst

@@ -80,3 +80,28 @@ async操作が禁じられている場所
             ...
         async for __ in async_iterator:  # 駄目
             ...
+
+
+-------------------
+プログラムの構造
+-------------------
+
+理想を言えばプログラムは一つだけ"root"タスクを持ち、他のタスクはその子や子孫であるべきです。
+そうする事でタスクの集合が一本の木で表され、プログラムの構造が明確になるからです。
+
+asynckivyでそれを実現するには :func:`asynckivy.start` の呼び出しを一度だけにし、他のタスクは全て
+:external+asyncgui:doc:`structured-concurrency-ja` を通して作ります。
+
+.. code-block::
+
+    import asynckivy as ak
+
+    class YourApp(App):
+        def on_start(self):
+            self._root_task = ak.start(self.main())
+
+        def on_stop(self):
+            self._root_task.cancel()
+
+        async def main(self):
+            ...

sphinx/notes.rst

@@ -121,3 +121,28 @@ Here is a list of them:
             ...
         async for __ in async_iterator:  # NOT ALLOWED
             ...
+
+
+-------------------------------
+How to structure your program
+-------------------------------
+
+Ultimately, your program should have only one "root" task, with all other tasks as its children or descendants.
+This is something that Trio forces you to do but asynckivy does not.
+
+You can achieve this by calling :func:`asynckivy.start` only once in your program,
+and spawning all other tasks through the :external+asyncgui:doc:`structured-concurrency` APIs.
+
+.. code-block::
+
+    import asynckivy as ak
+
+    class YourApp(App):
+        def on_start(self):
+            self._root_task = ak.start(self.main())
+
+        def on_stop(self):
+            self._root_task.cancel()
+
+        async def main(self):
+            ...