starred/pkl
1
0
Fork 0
mirror of https://github.com/apple/pkl.git synced 2026-03-17 23:03:54 +01:00
Code Issues 198 Packages Projects Releases 10 Wiki Activity

Introduce Typed objects before referring to them

Browse Source 
Currently, typed objects are only briefly mentioned in the sentence
stating that (typed) objects cannot be amended with new properties, only
existing ones. This is unnecessarily confusing since all examples up
until that point have been concerned with dynamic objects. Since the
tutorial goes on to amend a dynamic object with a new property in the
next section, a reader who isn't yet aware there are two types of
objects might be confused by what seems to be a contradiction.
This commit is contained in:
Hoxell
2024-02-11 18:48:26 +01:00
committed by Philip K.F. Hölzenspies
parent 14dec716cf
commit 8c254a9976
1 changed files with 3 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/modules/language-tutorial/pages/02_filling_out_a_template.adoc
View File

@@ -58,11 +58,11 @@ parrot {
}
----
[IMPORTANT]
[NOTE]
====
_Amending_ does not allow us to _add_ properties to the (typed) object we are amending.
So far, we have only worked with link:{uri-stdlib-Dynamic}[Dynamic] objects. The other type available to us is link:{uri-stdlib-Typed}[Typed] objects. _Amending_ allows us to override, amend, and add new properties to a dynamic object, but a typed object will only let us amend or override existing properties, not add entirely new ones.
The xref:03_writing_a_template.adoc[next part of the tutorial] discusses types in more detail.
There, you see that amending _never changes the type_ of the object.
There, you see that amending _never changes the type_ of a typed object.
====
You can also amend nested objects.