diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1bc1329..9f027b3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,4 +1,27 @@
 # Changelog
+### v1.0.0
+
+- Add example to readme
+
+
+- Fix XDG_CONFIG_HOME env var
+
+
+- Optionally automatically update dotfiles to and from settings
+  
+  Add a new config option to automatically apply files from settings, and to apply changes to the files back to settings.
+
+
+- Log files written to output channel
+
+
+- Add more links to marketplace listing
+  
+  Also use light background for gallery banner
+
+
+- Fix Makefile publish target
+
 ### v0.1.2
 
 - Add icon
diff --git a/README.md b/README.md
index 67d78ea..8cb2966 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,24 @@
 
 Configure dotfiles from your VS Code settings so they're always available.
 
+Run **dotfiles: Apply Config** from the command palette to write files to disk as defined in config (`dotfiles.files`).
+
+If `dotfiles.autoUpdate` is enabled, automatically apply config from settings to files on workbench open, and write changes to settings when saving a file in the editor that matches a file defined in `dotfiles.files`.
+
+## Example
+
+```json
+"dotfiles.files": {
+	"path/to/file.txt": "foo\nbar\n"
+}
+```
+
+writes file `$XDG_CONFIG_HOME/path/to/file.txt` with the content of the key.
+
 ## Extension Settings
 
-* `dotfiles.directory`: Base directory path for all config files to be written.
-* `dotfiles.files`: Files to be written to the configured directory, where key is the relative path to the file and value is the content of the file.
+||Description|Default|
+|-|-|-|
+|`dotfiles.directory`|Base directory path for all config files to be written.|`""`, meaning `$XDG_CONFIG_HOME` or `$HOME/.config` if unset.|
+|`dotfiles.files`|Files to be written to the configured directory, where key is the relative path to the file and value is the content of the file.|`{}`|
+|`dotfiles.autoUpdate`|Whether to automatically apply changes to files on workbench open, and persist changes back into settings from the editor.|`false`|
diff --git a/package-lock.json b/package-lock.json
index 13800b2..3d2e265 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "dotfiles",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "dotfiles",
-      "version": "0.1.2",
+      "version": "1.0.0",
       "license": "MIT",
       "devDependencies": {
         "@types/mocha": "^10.0.6",
diff --git a/package.json b/package.json
index 6420ef6..64a73f5 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
   },
   "description": "Apply dotfiles from settings",
   "icon": "images/icon-small.png",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "license": "MIT",
   "preview": true,
   "engines": {