From f1758bac4a0db868d43b3c05690a2153233da7ca Mon Sep 17 00:00:00 2001
From: cabboose <shayanftw@gmail.com>
Date: Sat, 5 Jul 2025 10:05:38 +0800
Subject: [PATCH 1/2] DOCS: Doc `??=` operator. Adjust prologue docs

---
 src/Fable.Core/Fable.Core.JsInterop.fs | 39 +++++++++++++++++++++++---
 1 file changed, 35 insertions(+), 4 deletions(-)

diff --git a/src/Fable.Core/Fable.Core.JsInterop.fs b/src/Fable.Core/Fable.Core.JsInterop.fs
index f9841984db..73149c9947 100644
--- a/src/Fable.Core/Fable.Core.JsInterop.fs
+++ b/src/Fable.Core/Fable.Core.JsInterop.fs
@@ -3,7 +3,18 @@ module Fable.Core.JsInterop
 open System
 open Fable.Core
 
-/// Compiles to ?? operator in JavaScript
+/// <summary>
+/// Compiles to <c>??</c> nullish coalescing operator in JavaScript.
+/// </summary>
+/// <remarks>
+/// <code lang="fsharp">
+/// expr1 ?? expr2
+/// </code>
+/// Returns <c>expr1</c> if it is neither <c>null</c> nor <c>undefined</c> on runtime; otherwise, returns <c>expr2</c>
+/// </remarks>
+/// <seealso href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Nullish_coalescing">
+/// JavaScript Documentation
+/// </seealso>
 [<Emit("$0 ?? $1")>]
 let (??=) (nullable: 'T) (defaultValue: 'T) : 'T = nativeOnly
 
@@ -48,20 +59,40 @@ let emitJsExpr<'T> (args: obj) (jsCode: string) : 'T = nativeOnly
 let emitJsStatement<'T> (args: obj) (jsCode: string) : 'T = nativeOnly
 
 /// <summary>
-/// Emit a directive prologue at the top of the file (before the imports)
-///
+/// Emit a directive prologue at the top of the file (before the imports).
+/// <br/><br/>
 /// This is useful when working with Next.js or other frameworks that require
 /// a specific directive at the top of the file, such as "use client" or "use server".
 /// </summary>
+/// <example><code lang="fsharp">
+/// let x = 5
+/// emitJsTopDirectivePrologue "use server"
+/// </code>
+/// Compiles to:
+/// <code lang="js">
+/// "use server";
+/// export const x = 5;
+/// </code>
+/// </example>
 /// <param name="text">Directive text</param>
 let emitJsTopDirectivePrologue (text: string) : unit = nativeOnly
 
 /// <summary>
 /// Emit a directive prologue at the calling position.
-///
+/// <br/><br/>
 /// This is useful when you need to emit a directive prologue for a specific part of the code,
 /// such as "use client" or "use server".
 /// </summary>
+/// <example><code lang="fsharp">
+/// let x = 5
+/// emitJsDirectivePrologue "use server"
+/// </code>
+/// Compiles to:
+/// <code lang="js">
+/// export const x = 5;
+/// "use server";
+/// </code>
+/// </example>
 /// <param name="text">Directive text</param>
 let emitJsDirectivePrologue (text: string) : unit = nativeOnly
 

From 1e198a328989652a66abe72e3c527249165723ea Mon Sep 17 00:00:00 2001
From: cabboose <shayanftw@gmail.com>
Date: Sat, 5 Jul 2025 10:18:51 +0800
Subject: [PATCH 2/2] DOCS: Use <para> instead of <br/>

---
 src/Fable.Core/Fable.Core.JsInterop.fs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/Fable.Core/Fable.Core.JsInterop.fs b/src/Fable.Core/Fable.Core.JsInterop.fs
index 73149c9947..f708c3ec2d 100644
--- a/src/Fable.Core/Fable.Core.JsInterop.fs
+++ b/src/Fable.Core/Fable.Core.JsInterop.fs
@@ -59,10 +59,9 @@ let emitJsExpr<'T> (args: obj) (jsCode: string) : 'T = nativeOnly
 let emitJsStatement<'T> (args: obj) (jsCode: string) : 'T = nativeOnly
 
 /// <summary>
-/// Emit a directive prologue at the top of the file (before the imports).
-/// <br/><br/>
-/// This is useful when working with Next.js or other frameworks that require
-/// a specific directive at the top of the file, such as "use client" or "use server".
+/// <para>Emit a directive prologue at the top of the file (before the imports).</para>
+/// <para>This is useful when working with Next.js or other frameworks that require
+/// a specific directive at the top of the file, such as "use client" or "use server".</para>
 /// </summary>
 /// <example><code lang="fsharp">
 /// let x = 5
@@ -78,10 +77,9 @@ let emitJsStatement<'T> (args: obj) (jsCode: string) : 'T = nativeOnly
 let emitJsTopDirectivePrologue (text: string) : unit = nativeOnly
 
 /// <summary>
-/// Emit a directive prologue at the calling position.
-/// <br/><br/>
-/// This is useful when you need to emit a directive prologue for a specific part of the code,
-/// such as "use client" or "use server".
+/// <para>Emit a directive prologue at the calling position.</para>
+/// <para>This is useful when you need to emit a directive prologue for a specific part of the code,
+/// such as "use client" or "use server".</para>
 /// </summary>
 /// <example><code lang="fsharp">
 /// let x = 5