diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0ee5707c9..028c7c001 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -87,3 +87,20 @@ To sync the colors of the different parts of the ui, we use the following rules:
 - `style("task").blue()`: The task name
 
 These styles are put in the `consts` module or are a `.fancy_display()` on the names. If you want to add a new generic color, please add it there.
+
+
+## Comment for Breaking Change
+If you have a work-around for a potential breaking change, please add a comment in the code where you think the breaking change will happen. And what needs to be done when we **actually** want to break it. Use `BREAK:` in the comment to denote this.
+
+For example:
+```rust
+// an enum to sort by size or name
+#[derive(clap::ValueEnum, Clone, Debug, Serialize)]
+pub enum SortBy {
+    Size,
+    Name,
+    // BREAK: remove the alias
+    #[value(alias = "type")]
+    Kind,
+}
+```
diff --git a/src/cli/list.rs b/src/cli/list.rs
index eae1bf599..8dcafe7c1 100644
--- a/src/cli/list.rs
+++ b/src/cli/list.rs
@@ -21,7 +21,9 @@ use crate::Project;
 pub enum SortBy {
     Size,
     Name,
-    Type,
+    // BREAK: remove the alias
+    #[value(alias = "type")]
+    Kind,
 }
 
 /// List project's packages. Highlighted packages are explicit dependencies.
@@ -187,7 +189,7 @@ pub async fn execute(args: Args) -> miette::Result<()> {
         SortBy::Name => {
             packages_to_output.sort_by(|a, b| a.name.cmp(&b.name));
         }
-        SortBy::Type => {
+        SortBy::Kind => {
             packages_to_output.sort_by(|a, b| a.kind.cmp(&b.kind));
         }
     }