From 01ba99b0613195c543d11af38476e3af67edae22 Mon Sep 17 00:00:00 2001
From: Timothee Guerin <tiguerin@microsoft.com>
Date: Fri, 1 Mar 2024 12:50:11 -0800
Subject: [PATCH] Fix dup doc (#2976)

Before
<img width="465" alt="image"
src="https://github.com/microsoft/typespec/assets/1031227/b620cac2-b70a-4a99-a784-bf03d55bd28b">

Now
<img width="413" alt="image"
src="https://github.com/microsoft/typespec/assets/1031227/d2a0b293-7924-44e7-9e1c-036ff40f1b6d">
---
 .chronus/changes/fix-dup-doc-2024-2-1-20-28-15.md | 8 ++++++++
 packages/compiler/src/lib/decorators.ts           | 2 +-
 packages/compiler/src/server/type-details.ts      | 4 ++--
 3 files changed, 11 insertions(+), 3 deletions(-)
 create mode 100644 .chronus/changes/fix-dup-doc-2024-2-1-20-28-15.md

diff --git a/.chronus/changes/fix-dup-doc-2024-2-1-20-28-15.md b/.chronus/changes/fix-dup-doc-2024-2-1-20-28-15.md
new file mode 100644
index 0000000000..1c45bcfe4c
--- /dev/null
+++ b/.chronus/changes/fix-dup-doc-2024-2-1-20-28-15.md
@@ -0,0 +1,8 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: fix
+packages:
+  - "@typespec/compiler"
+---
+
+[IDE] Fix type documentation shown twice when hovering symbols or in completion details.
diff --git a/packages/compiler/src/lib/decorators.ts b/packages/compiler/src/lib/decorators.ts
index 29866cd033..eba631960a 100644
--- a/packages/compiler/src/lib/decorators.ts
+++ b/packages/compiler/src/lib/decorators.ts
@@ -91,7 +91,7 @@ export interface DocData {
 
   /**
    * How was the doc set.
-   * - `@doc` means the `@doc` decorator was used
+   * - `decorator` means the `@doc` decorator was used
    * - `comment` means it was set from a `/** comment * /`
    */
   source: "decorator" | "comment";
diff --git a/packages/compiler/src/server/type-details.ts b/packages/compiler/src/server/type-details.ts
index 0d9c43fdde..67876a374e 100644
--- a/packages/compiler/src/server/type-details.ts
+++ b/packages/compiler/src/server/type-details.ts
@@ -64,8 +64,8 @@ function getSymbolDocumentation(program: Program, symbol: Sym) {
   // Add @doc(...) API docs
   const type = symbol.type ?? program.checker.getTypeForNode(symbol.declarations[0]);
   const apiDocs = getDocData(program, type);
-  // The doc comment is already included above we don't want to duplicate
-  if (apiDocs && apiDocs.source === "comment") {
+  // The doc comment is already included above we don't want to duplicate. Only include if it was specificed via `@doc`
+  if (apiDocs && apiDocs.source === "decorator") {
     docs.push(apiDocs.value);
   }