breaking change details

blog/2023-10-17-nushell_0_86.md

@@ -443,12 +443,64 @@ The following commands are being removed from Nushell:
 
 # Breaking changes [[toc](#table-of-content)]
 
+- [#10456](https://github.com/nushell/nushell/pull/10456) differentiating between `--x` and `--x: bool`
+
+In 0.86, we now differentiate between a switch `--x` and a flag with a boolean argument `--x: bool`. If you declare a flag as a parameter and give it the `: bool` type annotation, we now require that the flag is followed by a boolean value. Previously, we took the boolean type to mean that the flag was actually a switch.
+
 - [#10680](https://github.com/nushell/nushell/pull/10680) Use `heck` for string casing (again)
+
+## Before
+
+```
+G:/Dev/nu-itself/nushell> [UserID ABCdefGHI foo123bar] | str camel-case
+╭───┬───────────╮
+│ 0 │ userID    │
+│ 1 │ abcdefGHI │
+│ 2 │ foo123Bar │
+╰───┴───────────╯
+G:/Dev/nu-itself/nushell> [UserID ABCdefGHI foo123bar] | str snake-case
+╭───┬─────────────╮
+│ 0 │ user_id     │
+│ 1 │ ab_cdef_ghi │
+│ 2 │ foo_12_3bar │
+╰───┴─────────────╯
+```
+
+## After
+
+```
+G:/Dev/nu-itself/nushell> [UserID ABCdefGHI foo123bar] | str camel-case
+╭───┬───────────╮
+│ 0 │ userId    │
+│ 1 │ abCdefGhi │
+│ 2 │ foo123bar │
+╰───┴───────────╯
+G:/Dev/nu-itself/nushell> [UserID ABCdefGHI foo123bar] | str snake-case
+╭───┬─────────────╮
+│ 0 │ user_id     │
+│ 1 │ ab_cdef_ghi │
+│ 2 │ foo123bar   │
+╰───┴─────────────╯
+```
+
 - [#10341](https://github.com/nushell/nushell/pull/10341) remove `into decimal`
 - [#10342](https://github.com/nushell/nushell/pull/10342) remove `random decimal`
 - [#10588](https://github.com/nushell/nushell/pull/10588) Remove cd w/ abbreviations
+
+`cd` with abbreviations was a feature you could enable to expand an abbreviated path for you automatically. It would do so after you hit return. In comparing the experience between this and the fish-like path abbreviation completions added in 0.86, we decided the new style of completions satisfied this in a much more visual way.
+
 - [#10526](https://github.com/nushell/nushell/pull/10526) Rename: change the SyntaxShape of `-c` flag from list to record
-- [#10456](https://github.com/nushell/nushell/pull/10456) differentiating between `--x` and `--x: bool`
+
+After this change, we need to use -c flag like this:
+
+```
+> [[a, b, c]; [1, 2, 3]] | rename -c { a: ham }
+But we can rename many columns easily, here is another example:
+```
+
+```
+> [[a, b, c]; [1, 2, 3]] | rename -c { a: ham, b: ham2 }
+```
 
 # Full changelog [[toc](#table-of-content)]