Migrate docs from the other repo

docs/reference/input/rotation.md

@@ -0,0 +1,48 @@
+# Rotation
+
+Get a rotation angle in degrees inferred from the accelerometer readings.
+
+```sig
+input.rotation(Rotation.Roll);
+```
+
+### Parameters
+
+* kind: [String](/microbit/reference/types/string) - one of values specifying the kind of rotation: ``pitch`` (up/down around the ``x`` axis); ``roll`` (left/right around the ``y`` axis)
+
+### Returns
+
+* [Number](/microbit/reference/types/number) - angle, in degrees.
+
+### Example: micro:bit leveller
+
+The following example uses the `rotation` and the `plot leds` function to help you move the BBC micro:bit until it's level: when it is level, a smiley shows up on the screen. When running this code in a web browser, move your mouse to simulate the rotation.
+
+```sig
+basic.forever(() => {
+    let pitch = input.rotation(Rotation.Pitch)
+    let roll = input.rotation(Rotation.Roll)
+    if (Math.abs(pitch) < 10 && Math.abs(roll) < 10) {
+        basic.plotLeds(`
+. . . . .
+. # . # .
+. . . . .
+# . . . #
+. # # # .
+`)
+    } else {
+        basic.plotLeds(`
+# . . . #
+. # . # .
+. . # . .
+. # . # .
+# . . . #
+`)
+    }
+})
+```
+
+### See also
+
+[acceleration](/microbit/reference/input/acceleration), [compass-heading](/microbit/reference/input/compass-heading)
+