diff --git a/README.md b/README.md
index c97af55..68886fa 100644
--- a/README.md
+++ b/README.md
@@ -57,11 +57,25 @@ c -- a;
 
 ### Todo
 
+Todos can be defined with the `todo` function. In addition to being highlighted, the unresolved totos are listed at the end of the generated document.
+
 ```
 Lorem ipsum dolore #todo[sit] amet
 ```
 
+To mark a todo as resolved without deleting it, you can mark it as such:
+
+```
+Lorem ipsum dolore #todo(done: true)[sit] amet
+```
+
+To hid todos, you can add this line at the top of the document:
+
+```
+#show-todos.update(_ => false)
+```
+
 ## TODO:
 
 - biblio
-- add a list of all todo at the end of the file
+- What to do with resolved toto?
diff --git a/lib.typ b/lib.typ
index 477aabe..2ef8d32 100644
--- a/lib.typ
+++ b/lib.typ
@@ -29,5 +29,5 @@
   #show raw.where(lang: "graphLR"): it => render-image("graph mygraph { rankdir=\"TB\";" + it.text + "}")
   #show raw.where(lang: "graphTB"): it => render-image("graph mygraph { rankdir=\"TB\";" + it.text + "}")
   #doc
-  #todos
+  #todos()
 ]