deprecate io.debug in favour of echo

CHANGELOG.md

@@ -6,6 +6,8 @@
 - The `float` modeule gains the `to_precision` function.
 - The `try_fold` function in the `iterator` module is now tail recursive.
 - The performance of many functions in the `string` module has been improved.
+- The `debug` function in the `io` module has been deprecated in favour of
+  the `echo` keyword.
 
 ## v0.40.0 - 2024-08-19
 

src/gleam/io.gleam

@@ -105,6 +105,7 @@ fn do_println_error(string string: String) -> Nil
 /// // [2, 3]
 /// ```
 ///
+@deprecated("To debug print a value use the `echo` keyword instead")
 pub fn debug(term: anything) -> anything {
   term
   |> string.inspect