diff --git a/changelog.dd b/changelog.dd
deleted file mode 100644
index 3401fc7000..0000000000
--- a/changelog.dd
+++ /dev/null
@@ -1,27 +0,0 @@
-Ddoc
-
-$(COMMENT Pending changelog for 2.073. This will get copied to dlang.org and
-    cleared when master gets merged into stable.
-)
-
-$(BUGSTITLE Library Changes,
-)
-
-$(BUGSTITLE Library Changes,
-)
-
-Macros:
-    TITLE=Change Log
-
-    BUGSTITLE = <div class="bugsfixed">$(H4 $1) $(OL $2 )</div>
-
-    RELATIVE_LINK2=<a href="#$1">$+</a>
-    LNAME2=<a class="anchor" title="Permalink to this section" id="$1" href="#$1">$+</a>
-
-    BUGZILLA = <a href="https://issues.dlang.org/show_bug.cgi?id=$0">Bugzilla $0</a>
-
-    PULL_REQUEST = $(LINK2 https://github.com/dlang/$1/pull/$2, $1#$2)
-    DRUNTIMEPR = $(PULL_REQUEST druntime,$1)
-
-    BOOKTABLE = <table><caption>$1</caption>$+</table>
-    PRE = <pre>$0</pre>
diff --git a/changelog/README.md b/changelog/README.md
new file mode 100644
index 0000000000..48ceb6a06b
--- /dev/null
+++ b/changelog/README.md
@@ -0,0 +1,34 @@
+How to add a new changelog entry to the pending changelog?
+==========================================================
+
+This will get copied to dlang.org and cleared when master gets
+merged into stable prior to a new release.
+
+```
+My fancy new feature X
+
+A long description of the new feature.
+-------
+import std.range;
+import std.algorithm.comparison;
+
+assert([1, 2, 3, 4, 5].padLeft(0, 7).equal([0, 0, 1, 2, 3, 4, 5]));
+
+assert("Hello World!".padRight('!', 15).equal("Hello World!!!!"));
+-------
+```
+
+The title can't contain links (it's already one).
+For more infos, see the [Ddoc spec](https://dlang.org/spec/ddoc.html).
+
+Preview changes
+---------------
+
+If you have cloned the [tools](https://github.com/dlang/tools) and [dlang.org](https://github.com/dlang/dlang.org) repo),
+you can preview the changelog:
+
+```
+../tools/changed.d -o ../dlang.org/changelog/pending.dd && make -C ../dlang.org -f posix.mak html
+```
+
+and then open `../dlang.org/web/changelog/pending.html` with your favorite browser.