diff --git a/tools/compiler-common/src/diagnostics/MiraiConsoleErrors.kt b/tools/compiler-common/src/diagnostics/MiraiConsoleErrors.kt
index 7f2544a39..7f981069c 100644
--- a/tools/compiler-common/src/diagnostics/MiraiConsoleErrors.kt
+++ b/tools/compiler-common/src/diagnostics/MiraiConsoleErrors.kt
@@ -18,6 +18,11 @@ import org.jetbrains.kotlin.psi.KtCallExpression
 import org.jetbrains.kotlin.psi.KtNamedDeclaration
 import org.jetbrains.kotlin.psi.KtTypeProjection
 
+/**
+ * 如何增加一个错误:
+ * 1. 在 [MiraiConsoleErrors] 添加
+ * 2. 在 [MiraiConsoleErrorsRendering] 添加对应的 render
+ */
 object MiraiConsoleErrors {
     @JvmField
     val ILLEGAL_PLUGIN_DESCRIPTION = create<PsiElement, String>(ERROR)
diff --git a/tools/compiler-common/src/diagnostics/MiraiConsoleErrorsRendering.kt b/tools/compiler-common/src/diagnostics/MiraiConsoleErrorsRendering.kt
index effb040ff..5858bea53 100644
--- a/tools/compiler-common/src/diagnostics/MiraiConsoleErrorsRendering.kt
+++ b/tools/compiler-common/src/diagnostics/MiraiConsoleErrorsRendering.kt
@@ -22,6 +22,9 @@ import org.jetbrains.kotlin.diagnostics.rendering.DefaultErrorMessages
 import org.jetbrains.kotlin.diagnostics.rendering.DiagnosticFactoryToRendererMap
 import org.jetbrains.kotlin.diagnostics.rendering.Renderers
 
+/**
+ * @see MiraiConsoleErrors
+ */
 object MiraiConsoleErrorsRendering : DefaultErrorMessages.Extension {
     private val MAP = DiagnosticFactoryToRendererMap("MiraiConsole").apply {
         put(
diff --git a/tools/intellij-plugin/src/diagnostics/ContextualParametersChecker.kt b/tools/intellij-plugin/src/diagnostics/ContextualParametersChecker.kt
index 67d62adc1..4163b04d4 100644
--- a/tools/intellij-plugin/src/diagnostics/ContextualParametersChecker.kt
+++ b/tools/intellij-plugin/src/diagnostics/ContextualParametersChecker.kt
@@ -116,6 +116,7 @@ class ContextualParametersChecker : DeclarationChecker {
         @Suppress("UNUSED_PARAMETER")
         fun checkVersionRequirement(inspectionTarget: PsiElement, value: String): Diagnostic? {
             // TODO: 2020/10/23  checkVersionRequirement
+            // 实现: 先在 MiraiConsoleErrors 添加一个 error, 再检测 value 并 report 一个错误.
             return null
         }
     }