diff --git a/runtime/help/plugins.md b/runtime/help/plugins.md
index 1c64822b..3af94798 100644
--- a/runtime/help/plugins.md
+++ b/runtime/help/plugins.md
@@ -200,3 +200,5 @@ metadata for your plugin. Here is an example:
 
 Then open a pull request at github.com/micro-editor/plugin-channel adding a link to the
 raw `repo.json` that is in your plugin repository.
+To make updating the plugin work, the first line of your plugins lua code should contain the version of the plugin. (Like this: `VERSION = "1.0.0"`)
+Please make sure to use [semver](http://semver.org/) for versioning.
\ No newline at end of file