chore: update annotations

Author: nmerget

…mentation/godot-js-scripts/decorators.md …entation/godot-js-scripts/annotations.mddocs/documentation/godot-js-scripts/decorators.md renamed to docs/documentation/godot-js-scripts/annotations.md docs/documentation/godot-js-scripts/decorators.md renamed to docs/documentation/godot-js-scripts/annotations.md

@@ -1,8 +1,8 @@
-# Decorators
+# Annotations
 
-There are several decorators to help you define properties, signals, and other metadata for Godot objects.
+There are several annotations to help you define properties, signals, and other metadata for Godot objects.
 
-All decorators are accessed through the `createClassBinder` function:
+All annotations are accessed through the `createClassBinder` function:
 
 ```ts
 import { createClassBinder } from "godot.annotations";
@@ -131,3 +131,39 @@ accessor color: MyColor = MyColor.White;
 The value can be easily chosen from a dropdown list in the editor.
 
 ![enum_prop](images/export_enum_inspector.png)
+
+## Documentation comments
+
+You can use [documentation comments](https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/gdscript_documentation_comments.html)
+with custom GodotJS annotations:
+
+- ``@bind.help("...")``
+- ``@bind.experimental("...")``
+- ``@bind.deprecated("...")``
+
+```ts
+import { Variant } from "godot";
+import { createClassBinder } from "godot.annotations";
+
+const bind = createClassBinder();
+
+@bind()
+@bind.help("This will be shown in the editor when creating a new node of this type.")
+export default class TestNode extends Node {
+
+    @bind.experimental("Alternative to [method TestNode.doNewStuff].")
+    doNewStuff(){
+        // ...
+    }
+    
+    doStuff(){
+        // ...
+    }
+
+    @bind.deprecated("Use [method TestNode.doNewStuff] instead.")
+    doOldStuff(){
+        // ...
+    }
+    
+}
+```

docs/documentation/godot-js-scripts/intro.md

@@ -64,8 +64,8 @@ export default class MyJSNode extends Node {
 ## Annotations
 
 Annotations are used to define properties, signals, and other metadata for Godot objects.
-They are similar to decorators in TypeScript and can be used to enhance the functionality of your scripts.
-Check out [decorators](decorators.md) for more information.
+They are similar to annotations in TypeScript and can be used to enhance the functionality of your scripts.
+Check out [annotations](annotations.md) for more information.
 
 ## Auto-Completion and Codegen
 

mkdocs.yml

@@ -12,7 +12,7 @@ nav:
       - Use External Editor: documentation/use-external-editor.md
       - Scripting:
           - Intro: documentation/godot-js-scripts/intro.md
-          - Decorators: documentation/godot-js-scripts/decorators.md
+          - Annotations: documentation/godot-js-scripts/annotations.md
           - Signals: documentation/godot-js-scripts/signals.md
           - Cyclic Imports: documentation/godot-js-scripts/cyclic-imports.md
           - Bindings: documentation/godot-js-scripts/bindings.md