diff --git a/buffer/buffer.mbt b/buffer/buffer.mbt
index 5d111c236..2619a4324 100644
--- a/buffer/buffer.mbt
+++ b/buffer/buffer.mbt
@@ -13,7 +13,7 @@
 // limitations under the License.
 
 ///| Extensible buffer.
-/// @alert deprecated "Use type `T` instead"
+#deprecated("Use type `T` instead")
 pub(all) typealias Buffer = T
 
 ///|
diff --git a/builtin/arrayview.mbt b/builtin/arrayview.mbt
index 03bfe61a0..edf91f255 100644
--- a/builtin/arrayview.mbt
+++ b/builtin/arrayview.mbt
@@ -23,7 +23,7 @@
 /// assert_eq!(view[0], 2)
 /// assert_eq!(view.length(), 3)
 /// ```
-/// @alert deprecated "use @array.View instead"
+#deprecated("use @array.View instead")
 struct ArrayView[T] {
   buf : UninitializedArray[T]
   start : Int
diff --git a/builtin/builtin.mbti b/builtin/builtin.mbti
index 6a274191e..78dce5275 100644
--- a/builtin/builtin.mbti
+++ b/builtin/builtin.mbti
@@ -133,7 +133,7 @@ impl[T : Hash] Hash for Array[T]
 impl[X : Show] Show for Array[X]
 impl[X : ToJson] ToJson for Array[X]
 
-type ArrayView[T] //deprecated
+type ArrayView[T]
 impl ArrayView {
   length[T](Self[T]) -> Int
   op_as_view[T](Self[T], start~ : Int = .., end? : Int) -> Self[T]
diff --git a/json/types.mbt b/json/types.mbt
index e63884239..813062d3b 100644
--- a/json/types.mbt
+++ b/json/types.mbt
@@ -13,7 +13,7 @@
 // limitations under the License.
 
 ///|
-/// @alert deprecated "Definition of json is moved to builtin package, use `Json` instead"
+#deprecated("Definition of json is moved to builtin package, use `Json` instead")
 pub(all) typealias JsonValue = Json
 
 ///|
diff --git a/strconv/decimal.mbt b/strconv/decimal.mbt
index 0882397bc..471aa14fd 100644
--- a/strconv/decimal.mbt
+++ b/strconv/decimal.mbt
@@ -19,7 +19,7 @@
 /// reference:
 /// - <https://nigeltao.github.io/blog/2020/parse-number-f64-simple.html>
 /// - <https://nigeltao.github.io/blog/2020/eisel-lemire.html>
-/// @alert deprecated "Decimal will be changed to private. Use `@strconv.parse_double` instead"
+#deprecated("Decimal will be changed to private. Use `@strconv.parse_double` instead")
 struct Decimal {
   digits : FixedArray[Byte]
   mut digits_num : Int
diff --git a/strconv/strconv.mbti b/strconv/strconv.mbti
index dc8dcc7b3..858526ba4 100644
--- a/strconv/strconv.mbti
+++ b/strconv/strconv.mbti
@@ -23,7 +23,7 @@ fn shift(Decimal, Int) -> Unit
 fn to_double(Decimal) -> Double!StrConvError //deprecated
 
 // Types and methods
-type Decimal //deprecated
+type Decimal
 impl Decimal {
   #deprecated
   from_int64(Int64) -> Self