feat(editor): insert a documentation comment stub on Enter after /**

Enter after a /** that opens a new comment now closes it with the caret on the
summary line, in every language with /* */ comments. Above a PHP function or
method the stub lists its parameters (@param, with the declared type and
variadic ...) and the declared return type (@return; none for void and
constructors), as PhpStorm does. Settings › Editor › General › Smart Keys ›
Enter › Insert documentation comment stub turns it off.

src/platform/editorSettings.ts

@@ -152,6 +152,7 @@ export const EDITOR_EXTRA_DEFAULTS = {
     tabOutOfPair: true,
     reformatOnPaste: "indentEachLine",
     smartIndent: true,
+    insertDocStub: true,
     backspaceUnindent: "autoindent",
   },
   codeEditing: {

src/platform/locales/text/zh.json

@@ -2175,6 +2175,7 @@
   "Smart Step Into": "智能步入",
   "Smart Step Into failed": "智能步入失败",
   "Smart indent": "智能缩进",
+  "Insert documentation comment stub": "插入文档注释存根",
   "Soft": "软",
   "Soft Wraps": "软换行",
   "Soft-Wrap": "软换行",