diff --git a/doc/changelog.md b/doc/changelog.txt
similarity index 93%
rename from doc/changelog.md
rename to doc/changelog.txt
index 160b8b5a..be49ba69 100644
--- a/doc/changelog.md
+++ b/doc/changelog.txt
@@ -1,10 +1,9 @@
 # upcoming
 
-- (new) ui reworked
+- (new) user interface tweaks
 - (new) feed parser fully rewritten
 - (new) show youtube/vimeo iframes in "read here"
-- (new) keyboard shortcuts to scroll article content
-- (new) keyboard shortcut to "read here"
+- (new) keyboard shortcuts for article scrolling & toggling "read here"
 - (new) more options for auto-refresh intervals
 - (fix) `-base` not serving static files (thanks to @vfaronov)
 - (etc) 3rd-party dependencies reduced to the bare minimum
diff --git a/doc/technotes.md b/doc/platform.txt
similarity index 100%
rename from doc/technotes.md
rename to doc/platform.txt