Confusion of CLASS constructors/destructors with constructors/destructors for class INSTANCES
Based on forum topic: https://forum.lazarus.freepascal.org/index.php?topic=69812.
Issue
When looking for information about constructors/destructors, users look at the content and easily find a page mentioning them. But this is the "wrong" page (not the one they are usually looking for), which shows the use of "static" constructors/destructors. And the content of this page is very confusing for newbies, as happened to a user on the forum. The title of the page they are looking for is "Class instantiation", which does not even use the word "create" that is familiar to all programmers:
6.1 Class definitions
6.2 Abstract and sealed classes
6.3 Normal and static fields
6.3.1 Normal fields/variables
6.3.2 Class fields/variables
6.4 Class instantiation <----- for class INSTANCES
6.5 Class destruction <----- for class INSTANCES
6.6 Methods
6.6.1 Declaration
6.6.2 Invocation
6.6.3 Virtual methods
6.6.4 Class methods
6.6.5 Class constructors and destructors <----- for a class "TYPE"
6.6.6 Static class methods
6.6.7 Message methods
6.6.8 Using inherited
6.7 Properties
6.7.1 Definition
6.7.2 Indexed properties
6.7.3 Array properties
6.7.4 Default properties
6.7.5 Published properties
6.7.6 Storage information
6.7.7 Overriding and redeclaring properties
6.8 Class properties
6.9 Nested types, constants and variables
Pay attention to the names of these pages, they are almost impossible to distinguish:
Class instantiation
Class destruction
Class constructors and destructors
Suggestions
The page titles should be changed so that a newbie can easily get to the "right" page, which is almost always the one they are looking for. The page about constructors/destructors for instances should be called that (at least in brackets), and for the "type", on the contrary, it should be renamed to something "less catchy".
The page itself (where third-party links can easily lead) should also clearly indicate that we are talking about "static" constructors, which are rarely used.