document panelview

src/vs/base/browser/ui/splitview/panelview.ts

@@ -31,7 +31,13 @@ export interface IPanelStyles {
 }
 
 /**
- * Remember to call render after ctor
+ * A Panel is a structured SplitView view.
+ *
+ * WARNING: You must call `render()` after you contruct it.
+ * It can't be done automatically at the end of the ctor
+ * because of the order of property initialization in TypeScript.
+ * Subclasses wouldn't be able to set own properties
+ * before the `render()` call, thus forbiding their use.
  */
 export abstract class Panel implements IView {