diff --git a/my/books/kobo.py b/my/books/kobo.py
index 48b4606..09fa8c9 100644
--- a/my/books/kobo.py
+++ b/my/books/kobo.py
@@ -1,5 +1,5 @@
 """
-Kobo e-ink reader: annotations and reading stats
+[[https://uk.kobobooks.com/products/kobo-aura-one][Kobo]] e-ink reader: annotations and reading stats
 """
 from .. import init
 
diff --git a/my/calendar/holidays.py b/my/calendar/holidays.py
index c5cf9d9..5759ec8 100644
--- a/my/calendar/holidays.py
+++ b/my/calendar/holidays.py
@@ -1,5 +1,5 @@
 """
-Provides data on days off work (based on public holidays + manual inputs)
+Public holidays (automatic) and days off work (manual inputs)
 """
 
 from functools import lru_cache
diff --git a/my/coding/commits.py b/my/coding/commits.py
index 7c15f40..2f0b4f4 100644
--- a/my/coding/commits.py
+++ b/my/coding/commits.py
@@ -1,5 +1,5 @@
 """
-Git commits data: crawls filesystem
+Git commits data for repositories on your filesystem
 """
 
 from pathlib import Path
diff --git a/my/core/cachew.py b/my/core/cachew.py
index 551527a..94f0376 100644
--- a/my/core/cachew.py
+++ b/my/core/cachew.py
@@ -1,6 +1,4 @@
-'''
 # TODO this probably belongs to cachew? or cachew.experimental
-'''
 from contextlib import contextmanager
 
 
diff --git a/my/google/takeout/html.py b/my/google/takeout/html.py
index 2fccee9..b6c55d3 100644
--- a/my/google/takeout/html.py
+++ b/my/google/takeout/html.py
@@ -1,3 +1,7 @@
+'''
+Google Takeout exports: browsing history, search/youtube/google play activity
+'''
+
 from enum import Enum
 import re
 from pathlib import Path
diff --git a/my/hypothesis.py b/my/hypothesis.py
index 30229eb..16b48cd 100644
--- a/my/hypothesis.py
+++ b/my/hypothesis.py
@@ -1,5 +1,5 @@
 """
-Hypothes.is highlights and annotations
+[[https://hypothes.is][Hypothes.is]] highlights and annotations
 """
 from . import init
 
diff --git a/my/location/takeout.py b/my/location/takeout.py
index da53664..bb76292 100644
--- a/my/location/takeout.py
+++ b/my/location/takeout.py
@@ -1,5 +1,5 @@
 """
-Google Takeout data
+Location data from Google Takeout
 """
 
 import json
diff --git a/my/pdfs.py b/my/pdfs.py
index ba529e2..5e7a36f 100755
--- a/my/pdfs.py
+++ b/my/pdfs.py
@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 '''
-PDF annotations on your filesystem
+PDF documents and annotations on your filesystem
 '''
 
 from . import init
diff --git a/my/pinboard.py b/my/pinboard.py
index 68042a3..8685d50 100644
--- a/my/pinboard.py
+++ b/my/pinboard.py
@@ -1,5 +1,5 @@
 """
-pinboard.in bookmarks
+[[https://pinboard.in][Pinboard]] bookmarks
 """
 from . import init
 
diff --git a/my/reddit.py b/my/reddit.py
index 8a41463..36921e9 100755
--- a/my/reddit.py
+++ b/my/reddit.py
@@ -1,5 +1,5 @@
 """
-Reddit data: saved items/comments/upvotes etc
+Reddit data: saved items/comments/upvotes/etc.
 """
 from . import init
 
diff --git a/my/twitter/archive.py b/my/twitter/archive.py
index 3593048..afc1c8c 100755
--- a/my/twitter/archive.py
+++ b/my/twitter/archive.py
@@ -1,7 +1,5 @@
 """
-Twitter data (uses official twitter archive export)
-
-See https://help.twitter.com/en/managing-your-account/how-to-download-your-twitter-archive
+Twitter data (uses [[https://help.twitter.com/en/managing-your-account/how-to-download-your-twitter-archive][official twitter archive export]])
 """
 from datetime import datetime
 from typing import Union, List, Dict, Set, Optional, Iterator, Any, NamedTuple