From 78f3738080fb3d63d34c73e6c32bdd072aa115e5 Mon Sep 17 00:00:00 2001
From: Nicolas Stucki <nicolas.stucki@gmail.com>
Date: Wed, 17 Nov 2021 10:42:29 +0100
Subject: [PATCH] Improve issue templates

---
 .github/ISSUE_TEMPLATE/bug.md              | 6 ++++++
 .github/ISSUE_TEMPLATE/crash.md            | 6 ++++++
 .github/ISSUE_TEMPLATE/syntax-highlight.md | 7 +++++--
 3 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md
index d6a891e1c518..e7c8bcc40527 100644
--- a/.github/ISSUE_TEMPLATE/bug.md
+++ b/.github/ISSUE_TEMPLATE/bug.md
@@ -14,6 +14,12 @@ If you're not sure what version you're using, run `print scalaVersion` from sbt
 
 ## Minimized code
 
+<!--
+This code should be self contained, compilable (with possible failures) and as small as possible.
+
+Ideally, we should be able to just copy this code in a file and run `scalac` (and maybe `scala`) to reproduce the issue.
+-->
+
 ```Scala
 println("hello, world")
 ```
diff --git a/.github/ISSUE_TEMPLATE/crash.md b/.github/ISSUE_TEMPLATE/crash.md
index dc935e310548..390a57273260 100644
--- a/.github/ISSUE_TEMPLATE/crash.md
+++ b/.github/ISSUE_TEMPLATE/crash.md
@@ -14,6 +14,12 @@ If you're not sure what version you're using, run `print scalaVersion` from sbt
 
 ## Minimized code
 
+<!--
+This code should be self contained, compilable (with possible failures) and as small as possible.
+
+Ideally, we should be able to just copy this code in a file and run `scalac` (and maybe `scala`) to reproduce the issue.
+-->
+
 ```Scala
 println("hello, world")
 ```
diff --git a/.github/ISSUE_TEMPLATE/syntax-highlight.md b/.github/ISSUE_TEMPLATE/syntax-highlight.md
index 17b720d4d2aa..722c8ed5fa73 100644
--- a/.github/ISSUE_TEMPLATE/syntax-highlight.md
+++ b/.github/ISSUE_TEMPLATE/syntax-highlight.md
@@ -1,10 +1,13 @@
 ---
 name: Syntax highlighting
-about: Please create a syntax highlighting issue here https://github.com/scala/vscode-scala-syntax/issues
+about: ''
 title: ''
 labels: ''
 assignees: ''
 
 ---
 
-Please create a syntax highlighting issue here: [scala/vscode-scala-syntax](https://github.com/scala/vscode-scala-syntax/issues).
+Please create a syntax highlighting issue here
+* VS Code / GitHub: https://github.com/scala/vscode-scala-syntax/issues
+* IntelliJ: https://youtrack.jetbrains.com/issues/SCL?q=tag:%20%7BScala%203%7D%20tag:%20%7BSyntax%20Highlighting%7D
+* highlight.js: https://github.com/highlightjs/highlight.js/issues
\ No newline at end of file