From 335dd85172ca34fef1abd428b7de6048069ec69b Mon Sep 17 00:00:00 2001
From: Dirk Baeumer <dirkb@microsoft.com>
Date: Wed, 19 Dec 2018 17:23:33 +0100
Subject: [PATCH] Clarify ParameterInformation.label

---
 specification.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/specification.md b/specification.md
index 3fc48be..23614a9 100644
--- a/specification.md
+++ b/specification.md
@@ -3256,8 +3256,9 @@ interface ParameterInformation {
 	 * The label of this parameter information.
 	 *
 	 * Either a string or an inclusive start and exclusive end offsets within its containing
-	 * signature label. (see SignatureInformation.label). *Note*: A label of type string must be
-	 * a substring of its containing signature label.
+	 * signature label. (see SignatureInformation.label). *Note*: a label of type string should
+	 * be a substring of its containing signature label. Its intended use case is to highlight
+	 * the parameter label part in the `SignatureInformation.label`.
 	 */
 	label: string | [number, number];