You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The GDScripts Export tutorial doesn't mention @export_range annotations such as radians_to_degrees. Searching "godot export range angle" on the net gave me this page as first result, instead of the exhaustive doc on annotations, so this seems important to explain there.
Maybe we can't put everything in the tutorial, but then we should at least link to the documentation for people who need more info, the same way as @export_group has a hyperlink.
In fact, I noticed that other @export_ also missed a hyperlink, so we should probably add one for all of them: @export_file, @export_dir, etc.
Before each snippet introducing a new @export_ we could add "See @export_... (link to corresponding export doc)" and also a big link to the annotation section at the top.
For the "(link to corresponding export doc)", I didn't know how to get the url hash tag for a given section. Unlike tutorial headers which have a small ¶ symbol near them on hover to get the URL tag, doc sections have no such thing... But looking at the code on this repo, I found out that the marker used is @export_group <class_@GDScript_annotation_@export_group> to generate a link to "https://docs.godotengine.org/en/stable/classes/class_%40gdscript.html#class-gdscript-annotation-export-group" so that should be feasible for other @export_ variants by adapting the marker.
Your Godot version: v4.2
Issue description:
The GDScripts Export tutorial doesn't mention
@export_range
annotations such asradians_to_degrees
. Searching "godot export range angle" on the net gave me this page as first result, instead of the exhaustive doc on annotations, so this seems important to explain there.Maybe we can't put everything in the tutorial, but then we should at least link to the documentation for people who need more info, the same way as
@export_group
has a hyperlink.In fact, I noticed that other
@export_
also missed a hyperlink, so we should probably add one for all of them:@export_file
,@export_dir
, etc.Before each snippet introducing a new
@export_
we could add "See@export_...
(link to corresponding export doc)" and also a big link to the annotation section at the top.For the "(link to corresponding export doc)", I didn't know how to get the url hash tag for a given section. Unlike tutorial headers which have a small ¶ symbol near them on hover to get the URL tag, doc sections have no such thing... But looking at the code on this repo, I found out that the marker used is
@export_group <class_@GDScript_annotation_@export_group>
to generate a link to "https://docs.godotengine.org/en/stable/classes/class_%40gdscript.html#class-gdscript-annotation-export-group" so that should be feasible for other@export_
variants by adapting the marker.URL to the documentation page (if already existing):
https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/gdscript_exports.html#limiting-editor-input-ranges
The text was updated successfully, but these errors were encountered: