From a0bd642e70402bfeb2c5237c17e2e168ca83a2f9 Mon Sep 17 00:00:00 2001
From: Steven Orvell <sorvell@google.com>
Date: Mon, 22 Aug 2016 19:30:21 -0700
Subject: [PATCH] add TODO about need to review `finalize` api.

---
 src/elements/element.html | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/elements/element.html b/src/elements/element.html
index ef0bce5e50..d9a07208c3 100644
--- a/src/elements/element.html
+++ b/src/elements/element.html
@@ -98,6 +98,12 @@
         this.__finalized = value;
       }
 
+      // TODO(sorvell): need to work on public api surrouding `finalize`.
+      // Due to meta-programming, it's awkward to make a subclass impl of this.
+      // However, a user might want to call `finalize` prior to define to do
+      // this work eagerly. Need to also decide on `finalizeConfig(config)` and
+      // `finalizeTemplate(template)`. Both are public but have simiarly
+      // awkward subclassing characteristics.
       static _finalize() {
         var proto = this.prototype;
         if (!this._finalized) {