diff --git a/README.md b/README.md
index 09aa12e..fa6152c 100644
--- a/README.md
+++ b/README.md
@@ -69,7 +69,7 @@ this theme has been ported to a few different apps, and are included in the `ext
 * `miasma.Xresources` - colors for [xclients](https://wiki.archlinux.org/title/x_resources) (e.g. unix terminal emulators)
 * `miasma.itermcolors` - colors for [iterm2](https://iterm2.com)
 * `miasma.zsh` - colors for [zsh](https://zsh.org)
-* `miasma.yml` - colors for [alacritty](https://github.com/alacritty/alacritty)
+* `miasma.yml` - colors for [alacritty](https://alacritty.org)
 
 more on the way, and pr's for others are welcomed!
 
diff --git a/extras/miasma.yml b/extras/miasma.yml
index 0b66336..ca09ea6 100644
--- a/extras/miasma.yml
+++ b/extras/miasma.yml
@@ -1,11 +1,9 @@
-# Colors (Miasma)
+# colors (miasma) https://github.com/xero/miasma.nvim
 colors:
-  # Default colors
   primary:
     background: "#222222"
     foreground: "#c2c2b0"
 
-  # Normal colors
   normal:
     black: "#222222"
     red: "#685742"
@@ -16,7 +14,6 @@ colors:
     cyan: "#c9a554"
     white: "#d7c483"
 
-  # Bright colors
   bright:
     black: "#666666"
     red: "#685742"