diff --git a/plugins/discourse-details/README.md b/plugins/discourse-details/README.md
new file mode 100644
index 00000000000..afebd4f1a7a
--- /dev/null
+++ b/plugins/discourse-details/README.md
@@ -0,0 +1,27 @@
+### discourse-details
+
+HTML 5.1 `<details>` polyfill for [Discourse](https://www.discourse.org).
+
+NOTE: Does not work on IE9.
+
+## Usage
+
+In your posts, surround text with `[details=your summary]` ... `[/details]`.
+For example:
+
+```
+   I watched the murder mystery on TV last night. [details=Who did it?]The butler did it[/details].
+```
+
+## Installation
+
+Follow our [Install a Plugin](https://meta.discourse.org/t/install-a-plugin/19157) howto, using
+`git clone https://github.com/discourse/discourse-details.git` as the plugin command.
+
+## Issues
+
+If you have issues or suggestions for the plugin, please bring them up on [Discourse Meta](https://meta.discourse.org).
+
+## License
+
+MIT