diff --git a/scripts/asciidoc2html.py b/scripts/asciidoc2html.py
index 179989d1f..fc5a289fa 100644
--- a/scripts/asciidoc2html.py
+++ b/scripts/asciidoc2html.py
@@ -55,6 +55,7 @@ def call_asciidoc(src, dst):
 
 
 def main(colors=False):
+    """Generate html files for the online documentation."""
     utils.use_color = colors
     asciidoc_files = [
         ('doc/FAQ.asciidoc', 'qutebrowser/html/doc/FAQ.html'),
diff --git a/scripts/utils.py b/scripts/utils.py
index 503b7b39d..556ba0648 100644
--- a/scripts/utils.py
+++ b/scripts/utils.py
@@ -1,4 +1,5 @@
-#!/usr/bin/python3 # vim: ft=python fileencoding=utf-8 sts=4 sw=4 et:
+#!/usr/bin/python3
+# vim: ft=python fileencoding=utf-8 sts=4 sw=4 et:
 
 # Copyright 2014 Florian Bruhin (The Compiler) <mail@qutebrowser.org>
 
@@ -48,6 +49,7 @@ term_attributes = {
 
 
 def _esc(code):
+    """Get an ANSII color code based on a color number."""
     return '\033[{}m'.format(code)