Specs: note one of the big problems with the current style system: that rule order isn't maintained

sky/specs/style.md

Index: sky/specs/style.md
diff --git a/sky/specs/style.md b/sky/specs/style.md
index 82cb679116fbe241ee12f2e17d7a781fd5aabb58..96ff3af880b54b48a75a9856dd19a42537ed005b 100644
--- a/sky/specs/style.md
+++ b/sky/specs/style.md
@@ -256,6 +256,7 @@ class StyleDeclarationList {
   constructor ();
   void add(StyleDeclaration styles, String? pseudoElement = null); // O(1) // in debug mode, throws if the dictionary has any properties that aren't registered
   void remove(StyleDeclaration styles, String? pseudoElement = null); // O(N) in number of declarations
+  // TODO(ianh): Need to support inserting rules preserving order somehow
   Array<StyleDeclaration> getDeclarations(String? pseudoElement = null); // O(N) in number of declarations
 }
 
@@ -280,6 +281,8 @@ Each frame, at some defined point relative to requestAnimationFrame():
  - If a rule starts applying to an element, sky:core calls thatElement.style.add(rule.styles, rule.pseudoElement);
  - If a rule stops applying to an element, sky:core calls thatElement.style.remove(rule.styles, rule.pseudoElement);
 
+TODO(ianh): fix the above so that rule order is maintained
+
 
 Cascade
 -------