fix: all symbols summary and example title (#572)

Author: kt3k

deno.json

@@ -4,7 +4,7 @@
     "test": "deno test -A",
     "tailwind": "deno run -A build_css.ts",
     "gen_html": "deno task tailwind && cargo run --example ddoc --features=html -- --name \"std HTTP and Assert\" --html ../deno_std/http/mod.ts ../deno_std/assert/mod.ts ../deno_std/collections/mod.ts --output generated_docs/ --main_entrypoint ../deno_std/assert/mod.ts",
-    "test:update": "UPDATE=1 cargo test --locked --all-targets && UPDATE=1 cargo test --locked --all-targets --features=tree-sitter && UPDATE=1 cargo test --locked --all-targets --features=syntect"
+    "test:update": "UPDATE=1 cargo test --locked --all-targets && UPDATE=1 cargo test --locked --all-targets --features=tree-sitter && UPDATE=1 cargo test --locked --all-targets --features=syntect && cargo insta test --review"
   },
   "exclude": [
     "target",

src/html/jsdoc.rs

@@ -389,7 +389,7 @@ pub(crate) fn render_markdown_summary(
     md,
     MarkdownToHTMLOptions {
       summary: true,
-      summary_prefer_title: false,
+      summary_prefer_title: true,
     },
   )
   .unwrap_or_default()
@@ -418,7 +418,7 @@ pub(crate) fn jsdoc_body_to_html(
       doc,
       MarkdownToHTMLOptions {
         summary,
-        summary_prefer_title: false,
+        summary_prefer_title: true,
       },
     )
   } else {

tests/snapshots/html_test__html_doc_files_rewrite-16.snap

@@ -115,7 +115,8 @@ Classes</h2></div><div class="namespaceSection"><div class="namespaceItem" ><div
 <div class="namespaceItemContent">
 		    <a href="..&#x2F;.&#x2F;.&#x2F;~&#x2F;Foo.html" title="Foo">Foo</a>
 
-	      <div><span class="italic">No documentation available</span></div>
+	      <div><div class="markdown_summary"><p>some Foo docs</p>
+</div></div>
       </div>
     </div><div class="namespaceItem" ><div class="docNodeKindIcon"><div class="text-Class bg-Class/15" title="Class">c</div></div>
 <div class="namespaceItemContent">

tests/snapshots/html_test__html_doc_files_rewrite.snap

@@ -75,7 +75,8 @@ expression: "files.get(\"./all_symbols.html\").unwrap()"
 <div class="namespaceItemContent">
 		    <a href=".&#x2F;.&#x2F;.&#x2F;~&#x2F;Foo.html" title="Foo">Foo</a>
 
-	      <div><span class="italic">No documentation available</span></div>
+	      <div><div class="markdown_summary"><p>some Foo docs</p>
+</div></div>
       </div>
     </div><div class="namespaceItem" ><div class="docNodeKindIcon"><div class="text-Class bg-Class/15" title="Class">c</div></div>
 <div class="namespaceItemContent">