diff --git a/crates/biome_js_analyze/src/assists/source/sort_jsx_props.rs b/crates/biome_js_analyze/src/assists/source/sort_jsx_props.rs
index 8bae5121ef0c..5c85875e4955 100644
--- a/crates/biome_js_analyze/src/assists/source/sort_jsx_props.rs
+++ b/crates/biome_js_analyze/src/assists/source/sort_jsx_props.rs
@@ -25,18 +25,12 @@ declare_source_rule! {
     ///
     /// ## Examples
     ///
-    /// ### Invalid
-    ///
-    /// ```js,expect_diagnostic
+    /// ```js,expect_diff
     /// <Hello lastName="Smith" firstName="John" />;
     /// ```
     ///
-    /// ### Valid
-    ///
-    /// ```js
-    /// <Hello firstName="John" lastName="Smith" />;
-    /// <Hello lastName="Smith" {...this.props} firstName="John" />;
-    /// <Hello tel={5555555} {...this.props} firstName="John"  {...another.props} lastName="Smith" />;
+    /// ```js,expect_diff
+    /// <Hello lastName="Smith" firstName="John" {...this.props} tel="0000" address="111 Main Street"  {...another.props} lastName="Smith" />;
     /// ```
     ///
     pub SortJsxProps {
diff --git a/crates/biome_json_analyze/src/assists/source/use_sorted_keys.rs b/crates/biome_json_analyze/src/assists/source/use_sorted_keys.rs
index 7d40de1dfdc8..eb01ae490ce7 100644
--- a/crates/biome_json_analyze/src/assists/source/use_sorted_keys.rs
+++ b/crates/biome_json_analyze/src/assists/source/use_sorted_keys.rs
@@ -14,6 +14,18 @@ use std::collections::BTreeSet;
 
 declare_source_rule! {
     /// Sorts the keys of a JSON object in natural order
+    ///
+    /// ## Examples
+    ///
+    /// ```json,expect_diff
+    /// {
+    ///     "vase": "fancy",
+    ///     "nested": {
+    ///         "omega": "bar",
+    ///         "alpha": "foo"
+    ///     }
+    /// }
+    /// ```
     pub UseSortedKeys {
         version: "1.9.0",
         name: "useSortedKeys",
diff --git a/crates/biome_lsp_converters/README.md b/crates/biome_lsp_converters/README.md
index 4bb64274743b..cb922e50fbe1 100644
--- a/crates/biome_lsp_converters/README.md
+++ b/crates/biome_lsp_converters/README.md
@@ -1,3 +1,19 @@
+<p align="center">
+	<img alt="Biome - Toolchain of the web" width="400" src="https://raw.githubusercontent.com/biomejs/resources/main/svg/slogan-light-transparent.svg"/>
+</p>
+
+<div align="center">
+
+[![Discord chat][discord-badge]][discord-url]
+[![cargo version][cargo-badge]][cargo-url]
+
+[discord-badge]: https://badgen.net/discord/online-members/BypW39g6Yc?icon=discord&label=discord&color=green
+[discord-url]: https://biomejs.dev/chat
+[cargo-badge]: https://badgen.net/crates/v/biome_lsp_converters?&color=green
+[cargo-url]: https://crates.io/crates/biome_lsp_converters/
+
+</div>
+
 # `biome_lsp_converters`
 
 The crate contains a set of converters to translate between `lsp-types` and `biome_rowan` (and vice versa) types.
diff --git a/crates/biome_lsp_converters/src/lib.rs b/crates/biome_lsp_converters/src/lib.rs
index b3aa22c22e3f..62e6410a1e60 100644
--- a/crates/biome_lsp_converters/src/lib.rs
+++ b/crates/biome_lsp_converters/src/lib.rs
@@ -1,3 +1,5 @@
+//! The crate contains a set of converters to translate between `lsp-types` and `biome_rowan` (and vice versa) types.
+
 use biome_rowan::TextSize;
 use tower_lsp::lsp_types::{ClientCapabilities, PositionEncodingKind};