diff --git a/scadnano/scadnano.py b/scadnano/scadnano.py
index 269ca63d..b5db5530 100644
--- a/scadnano/scadnano.py
+++ b/scadnano/scadnano.py
@@ -2260,7 +2260,15 @@ def loopout(self, helix: int, length: int, offset: Optional[int] = None, move: O
 
     def extension(self, length: int) -> 'StrandBuilder[StrandLabel, DomainLabel]':
         """
-        TODO: write doc
+        Add extension.
+
+        If called before any domains have been created, then the extension will only be added
+        when a domain has been created.
+
+        If called after domains have been created, then the extension will be added to the end
+        of the strand.
+
+        Extensions can either be at the start or end of a strand and not in the middle.
         """
         if self._strand is None:
             # 5' extension