[TYPO3-doc] proposal: TS prevention of ambiguous namings

[Elmar Hinz]

How to prevent this double entendre of TS namings?

I would propose to use the terms of xPath on the syntax level and to
speak of "leaves" and "nodes" instead of properties here. Then we can
make very clear definitions:

1.) Nodes have a dot at the end of their name.
2.) Leaves have not a dot at the end of their name.
3.) Leaves and nodes can occur as a pair, of the same name each with
the different of the ending dot.
4.) Data types both define leaves and nodes.
5.) Regularly data types define the common behaviour of a leaf node pair.
6.) Properties describe the leaf part of a pair or a single leaf.
7.) Functions describe the node part of a pair or a single node.
8.) Objects are defined by a leaf node pair where the leaf is the
Object class and the node is the container of the object.

All in all we would use the terms: leaf, node, property, function,
object, container.


Regards

Elmar