Migrate docs from the other repo

docs/reference/pins/digital-write-pin.md

@@ -0,0 +1,35 @@
+# Digital Write Pin
+
+Write the value ``0`` or ``1`` to the specified (digital) [pin](/microbit/device/pins). **Some pins are also used by the display, read the [pin documentation ](/microbit/device/pins) carefully.**
+
+```sig
+pins.digitalWritePin(DigitalPin.P1, 1)
+```
+
+### Parameters
+
+* name - the pin name (``P0``, ``P1``, ``P2``, ...)
+* value - [Number](/microbit/reference/types/number); 0 or 1
+
+### Example: football score keeper
+
+The following example reads `P0` to determine when a goal is scored. When `P0 = 1`, the code uses `digital write pin` to play a buzzer sound:
+
+```blocks
+let score = 0
+basic.showNumber(score)
+basic.forever(() => {
+    if (pins.digitalReadPin(DigitalPin.P0) == 1) {
+        score++;
+        pins.digitalWritePin(DigitalPin.P2, 1)
+        basic.showNumber(score)
+        basic.pause(1000)
+        pins.digitalWritePin(DigitalPin.P2, 0)
+    }
+})
+```
+
+### See also
+
+[micro:bit pins](/microbit/device/pins), [digital read pin](/microbit/reference/pins/digital-read-pin), [analog read pin](/microbit/reference/pins/analog-read-pin), [analog write pin](/microbit/reference/pins/analog-write-pin), [on pin pressed](/microbit/reference/input/on-pin-pressed), [pin is pressed](/microbit/reference/pins/pin-is-pressed)
+