Semantic rendering still possible with `renderer: <fn>`?

[boghyon]

Given:

Control.extend("sap.mylib.MyControl", {
  metadata : {
    // ...
  },
  renderer: function(oRM, oControl) {
    oRM.openStart("div", oControl);
    // ...
    oRM.openEnd();
    oRM.text(oControl.getText());
    oRM.close("div");
  }
});

Question:

According to the API reference, specifying the render function directly is still allowed:
https://github.com/SAP/openui5/blob/19ecd4255dbf3a65bf737502880b65cc1a533888/src/sap.ui.core/src/sap/ui/core/Control.js#L224

..which can be also seen in a walkthrough step.

But with that approach, due to the missing apiVersion: 2 flag, in-place DOM patching isn't performed.
Is there a plan to implicitly enable apiVersion: 2 in that case?

[codeworrior]

No, no plan. If you want to use apiVersion=2, please use an object with a render property, not only a function.

[boghyon]

Since it's now encouraged to enable apiVersion: 2, and because in-place DOM patching is not possible otherwise, wouldn't it be appropriate to remove renderer: <fn>-approach from the doc?