docs: add more content

diff.bzl

@@ -1,14 +1,30 @@
-"Create and Update Patches"
+"""
+# `diff` Utils 
+
+Create and Update Patches
+
+```starlark
+load("@bzlparty_tools//:diff.bzl", "diff", "update_patches")
+
+diff(
+    name = "module_bazel",
+    source = "//:MODULE.bazel",
+    target = ":MODULE.bazel",
+)
+
+update_patches()
+```
+
+> [!NOTE]
+> The `diff` rule uses the `diff` command from the host system.
+> There is no toolchain that uses a platform specific tool.
+"""
 
 load("@aspect_bazel_lib//lib:write_source_files.bzl", "write_source_files")
 
 def diff(name, source, target, input = None):
     """Create a patch file from `source` and `target` files.
 
-    > [!NOTE]
-    > This is a simple rule that uses the `diff` command from the host system.
-    > There is no toolchain that uses a platform specific tool.
-
     Args:
       name: A unique name for the target.
       source: Source file to create the patch for.

docs/diff.md

@@ -1,7 +1,27 @@
 <!-- Generated with Stardoc: http://skydoc.bazel.build -->
 
+
+# `diff` Utils 
+
 Create and Update Patches
 
+```starlark
+load("@bzlparty_tools//:diff.bzl", "diff", "update_patches")
+
+diff(
+    name = "module_bazel",
+    source = "//:MODULE.bazel",
+    target = ":MODULE.bazel",
+)
+
+update_patches()
+```
+
+&gt; [!NOTE]
+&gt; The `diff` rule uses the `diff` command from the host system.
+&gt; There is no toolchain that uses a platform specific tool.
+
+
 <a id="diff"></a>
 
 ## diff
@@ -12,11 +32,6 @@ diff(<a href="#diff-name">name</a>, <a href="#diff-source">source</a>, <a href="
 
 Create a patch file from `source` and `target` files.
 
-&gt; [!NOTE]
-&gt; This is a simple rule that uses the `diff` command from the host system.
-&gt; There is no toolchain that uses a platform specific tool.
-
-
 **PARAMETERS**
 
 

docs/platforms.md

@@ -1,6 +1,10 @@
 <!-- Generated with Stardoc: http://skydoc.bazel.build -->
 
-Default platform mapping and helpers
+
+# Platforms 
+
+Default platform mappings and helpers
+
 
 <a id="host_platform"></a>
 

platforms.bzl

@@ -1,4 +1,8 @@
-"Default platform mapping and helpers"
+"""
+# Platforms 
+
+Default platform mappings and helpers
+"""
 
 load("@local_config_platform//:constraints.bzl", "HOST_CONSTRAINTS")