Node.raise() is misleading

[KoBeWi]

Godot version:
3.1.1

Issue description:
The description of this method says:

Moves this node to the top of the array of nodes of the parent node.

What does the "top of the array" mean? I interpreted it as it moves it as first child, but actually it's the opposite. The documentation should clearly state where the node will move instead of using vague terms.

[Zylann]

It is called raise() because it was made for bringing the node visually on top of its siblings in 2D. For that, the node has to be moved to the bottom of the list, so the doc is wrong indeed.
But considering it's a Node method in an engine where also 3D and non-graphic things exist, raise is quite a generic term which could be interpreted in many ways...
Another candidate for #16863 ?

[Zireael07]

Definitely a candidate for renaming, neither the docs nor the name say what it does.

[regakakobigman]

The name is also confusing to anyone expecting raise() to be a counterpart to Python's raise statement.

[aaronfranke]

If this method is desired, I think it would make sense to move it to CanvasItem.

[bojidar-bg]

@aaronfranke the problem with doing this is that while raise() is mostly useful only for CanvasItem, its functionality does not depend on CanvasItem in any way, and thus it makes little sense to be there.

[Zylann]

@bojidar-bg does it have a use case in 3D though? It seems to be way less common.

[KoBeWi]

Tree order affects e.g. processing order, so technically it has use in any node.

[Zylann]

@KoBeWi This has an effect for sure, but then the use case is different.
Do we want a general move_to_end function that moves a node to the end in an attempt to fulfill different use cases (for which it would have needed different names anyways) ;
or, do we want bring_to_front, in which case it makes sense to move it to CanvasItem, matching the use name it was originally intented for.
The function is a shortcut to a one-liner, so common use case matters more than what it actually does.

[KoBeWi]

The doc was updated, but what should we do with the method? Rename? (could be called move_to_top()) Remove?