Skip to content

Commit 51c40a2

Browse files
committed
Expand GDScript guidelines with guidelines from the main repository.
1 parent 8bc0b6a commit 51c40a2

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

engine/guidelines/gdscript_language_guidelines.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,21 @@
11
GDScript language design guidelines
22
===================================
33

4+
GDScript is a tightly designed language: Features are added because they are needed,
5+
and not because they can be added or are interesting to develop. For more information,
6+
please refer to :ref:`doc_best_practices_for_engine_contributors`.
7+
8+
Typing guidelines
9+
-----------------
10+
11+
GDScript is gradually typed. Type hints are optional and help with static analysis and performance.
12+
However, typed code must easily interoperate with untyped code.
13+
gIn addition, we expect new typing features to be guaranteed by Godot core. While other
14+
languages can rely on static typing alone to ensure type correctness, Godot exposes
15+
lots of ways to interact with the data such that this assumption might fail.
16+
Therefore, new typing features need to be guaranteed by core in order to be useful to
17+
GDScript.
18+
419
Annotation guidelines
520
---------------------
621

0 commit comments

Comments
 (0)