    :extensions [".html"]})
 
 (deftask slug
-  "Adds :slug key to files metadata. Slug is derived from filename."
+  "Renames a file so that the part before the extension matches the result of `slug-fn`"
   [s slug-fn    SLUGFN     code  "function to build slug from file metadata"
    _ filterer   FILTER     code  "predicate to use for selecting entries (default: `identity`)"
    e extensions EXTENSIONS [str] "extensions of files to include"]

      :pod pod})))

(deftask markdown
  "Parse markdown files

  This task will look for files ending with `md` or `markdown`
  and writes an HTML file that contains the result from

   :extensions [".html"]})

(deftask permalink
  "Moves a file so that its location matches the result of `permalink-fn`"
  [p permalink-fn PERMALINKFN code  "function to build permalink from TmpFile metadata"
   _ filterer     FILTER      code  "predicate to use for selecting entries (default: `identity`)"
   e extensions   EXTENSIONS  [str] "extensions of files to include"]
