Specs: Split apis.md into dom.md, events.md, idl.md, and move the remainder into README.md and modu…

sky/specs/animation.md

Index: sky/specs/animation.md
diff --git a/sky/specs/animation.md b/sky/specs/animation.md
new file mode 100644
index 0000000000000000000000000000000000000000..e101bb4f46b265905c32ff9ea53310b7e958eceb
--- /dev/null
+++ b/sky/specs/animation.md
@@ -0,0 +1,21 @@
+Animation API
+=============
+
+```javascript
+
+dictionary EasingFunctionSettings {
+  Float duration; // required
+  Callback? completionCallback = null;
+}
+
+abstract class EasingFunction {
+  abstract constructor (EasingFunctionSettings settings);
+  abstract Float getFactor(Float time);
+    // calls completionCallback if time >= duration
+    // then returns a number ostensibly in the range 0.0 to 1.0
+    // (but it could in practice go outside this range, e.g. for
+    // animation styles that overreach then come back)
+}
+
+
+```