diff --git a/assets/icons/arrow_circle.svg b/assets/icons/arrow_circle.svg
index 790428702e121d523a862517cedf1414f003b93c..76363c6270890d51e5946664fa4943e5b16aca0c 100644
--- a/assets/icons/arrow_circle.svg
+++ b/assets/icons/arrow_circle.svg
@@ -1,6 +1,6 @@
diff --git a/assets/icons/blocks.svg b/assets/icons/blocks.svg
index 128ca84ef19a420fe2bdd73d8ae80b48d2d944e7..e1690e2642b60d93893e52008c6d10d96e810d48 100644
--- a/assets/icons/blocks.svg
+++ b/assets/icons/blocks.svg
@@ -1 +1,3 @@
-
+
diff --git a/assets/icons/folder_search.svg b/assets/icons/folder_search.svg
index 15b0705dd641271fca18991b73f600f83c646245..d1bc537c98bb8d4029f2c368297fad51557e966e 100644
--- a/assets/icons/folder_search.svg
+++ b/assets/icons/folder_search.svg
@@ -1,5 +1,5 @@
diff --git a/assets/icons/maximize.svg b/assets/icons/maximize.svg
index c51b71aaf00c997b8956c4010922f0eb8a231188..ee03a2c0210586a0cf0744df051414451e92f2f6 100644
--- a/assets/icons/maximize.svg
+++ b/assets/icons/maximize.svg
@@ -1,6 +1,6 @@
diff --git a/assets/icons/minimize.svg b/assets/icons/minimize.svg
index 97d4699687d5b8255ecf89800dae277a5d55d669..ea825f054ed1813aff11d2838b2c0e8e2211d717 100644
--- a/assets/icons/minimize.svg
+++ b/assets/icons/minimize.svg
@@ -1,6 +1,6 @@
diff --git a/assets/icons/scissors.svg b/assets/icons/scissors.svg
index 89d246841e58334e5954b1a48bad3b195b64e7ba..430293f9138947b35a96ff04db27db657320f64d 100644
--- a/assets/icons/scissors.svg
+++ b/assets/icons/scissors.svg
@@ -1 +1,3 @@
-
+
diff --git a/crates/icons/README.md b/crates/icons/README.md
index 5fbd6d494831214ca810926d8ff873850e5a3cf4..71bc5c85459604243207c68686da5662ceabeddc 100644
--- a/crates/icons/README.md
+++ b/crates/icons/README.md
@@ -3,27 +3,27 @@
## Guidelines
Icons are a big part of Zed, and they're how we convey hundreds of actions without relying on labeled buttons.
-When introducing a new icon to the set, it's important to ensure it is consistent with the whole set, which follows a few guidelines:
+When introducing a new icon, it's important to ensure consistency with the existing set, which follows these guidelines:
1. The SVG view box should be 16x16.
2. For outlined icons, use a 1.5px stroke width.
-3. Not all icons are mathematically aligned; there's quite a bit of optical adjustment. But try to keep the icon within an internal 12x12 bounding box as much as possible while ensuring proper visibility.
-4. Use the `filled` and `outlined` terminology when introducing icons that will have the two variants.
+3. Not all icons are mathematically aligned; there's quite a bit of optical adjustment. However, try to keep the icon within an internal 12x12 bounding box as much as possible while ensuring proper visibility.
+4. Use the `filled` and `outlined` terminology when introducing icons that will have these two variants.
5. Icons that are deeply contextual may have the feature context as their name prefix. For example, `ToolWeb`, `ReplPlay`, `DebugStepInto`, etc.
-6. Avoid complex layer structure in the icon SVG, like clipping masks and whatnot. When the shape ends up too complex, we recommend running the SVG in [SVGOMG](https://jakearchibald.github.io/svgomg/) to clean it up a bit.
+6. Avoid complex layer structures in the icon SVG, like clipping masks and similar elements. When the shape becomes too complex, we recommend running the SVG through [SVGOMG](https://jakearchibald.github.io/svgomg/) to clean it up.
## Sourcing
Most icons are created by sourcing them from [Lucide](https://lucide.dev/).
Then, they're modified, adjusted, cleaned up, and simplified depending on their use and overall fit with Zed.
-Sometimes, we may use other sources like [Phosphor](https://phosphoricons.com/), but we also design many of them completely from scratch.
+Sometimes, we may use other sources like [Phosphor](https://phosphoricons.com/), but we also design many icons completely from scratch.
## Contributing
-To introduce a new icon, add the `.svg` file in the `assets/icon` directory and then add its corresponding item in the `icons.rs` file within the `crates` directory.
+To introduce a new icon, add the `.svg` file to the `assets/icon` directory and then add its corresponding item to the `icons.rs` file within the `crates` directory.
-- SVG files in the assets folder follow a snake case name format.
-- Icons in the `icons.rs` file follow the pascal case name format.
+- SVG files in the assets folder follow a snake_case name format.
+- Icons in the `icons.rs` file follow the PascalCase name format.
-Ensure you tag a member of Zed's design team so we can adjust and double-check any newly introduced icon.
+Make sure to tag a member of Zed's design team so we can review and adjust any newly introduced icon.