minor documentation changes

Author: mathertel

.gitignore

@@ -1,2 +1,2 @@
 .DS_Store
-.idea/
+.idea/

README.md

@@ -1,38 +1,60 @@
 Arduino OneButton Library
 ===
 
-This Arduino libary is improving the usage of a singe button for input.
+This Arduino library is improving the usage of a singe button for input.
 It shows how to use an digital input pin with a single pushbutton attached
 for detecting some of the typical button press events like single clicks, double clicks and long-time pressing.
 This enables you to reuse the same button for multiple functions and lowers the hardware investments.
 
 This is also a sample for implementing simple finite-state machines by using the simple pattern above. 
 
-You can find more detail on this library at
+You can find more details on this library at
 http://www.mathertel.de/Arduino/OneButtonLibrary.aspx
 
+
 ## Getting Started
 
 Clone this repository into `Arduino/Libraries` or use the built-in Arduino IDE Library manager to install
 a copy of this library. You can find more detail about installing libraries 
 [here, on Arduino's website](https://www.arduino.cc/en/guide/libraries).
 
-```c++
+```CPP
 #include <Arduino.h>
 #include <OneButton.h>
 ```
 
-### Initialize a Button
-
 Each physical button requires its own `OneButton` instance. You can initialize them like this:
 
-```c++
+
+### Initialize a Button to GND
+
+```CPP
+#define BUTTON_PIN 4
+
+/**
+ * Initialize a new OneButton instance for a button
+ * connected to digital pin 4 and GND, which is active low
+ * and uses the internal pull-up resistor.
+ */
+
+OneButton btn = OneButton(
+  BUTTON_PIN, // Input pin for the button
+  LOW,       // Button is active LOW
+  true       // Enable internal pull-up resistor
+);
+```
+
+
+### Initialize a Button to VCC
+
+```CPP
 #define BUTTON_PIN 4
 
 /**
  * Initialize a new OneButton instance for a button
- * connected to digital pin 4, which is active high,
- * and does not use the internal pull-up resistors.
+ * connected to digital pin 4, which is active high.
+ * As this does not use any internal resistor
+ * an external resistor (4.7k) may be required to create a LOW signal when the button is not pressed.
  */
 
 OneButton btn = OneButton(
@@ -42,12 +64,13 @@ OneButton btn = OneButton(
 );
 ```
 
+
 ### Attach State Events
 
 Once you have your button initialized, you can handle events by attaching them to the button
 instance. Events can either be static functions or lambdas (without captured variables).
 
-```c++
+```CPP
 // Handler function for a single click:
 static void handleClick() {
   Serial.println("Clicked!");
@@ -62,31 +85,34 @@ btn.attachDoubleClick([]() {
 });
 ```
 
+
 ### Don't forget to `tick()`!
 
 In order for `OneButton` to work correctly, you must call `tick()` on __each button instance__
 within your main `loop()`. If you're not getting any button events, this is probably why.
 
-```c++
+```CPP
 void loop() {
   btn.tick();
 
   // Do other things...
 }
 ```
 
+
 ## State Events
 
 Here's a full list of events handled by this library:
 
-|Attach Function|Description|
-|---|---|
-|`attachClick`|Fires as soon as a single click is detected.|
-|`attachDoubleClick`|Fires as soon as a double click is detected.|
-|`attachPressStart`|Fires as soon as the button is pressed down.|
-|`attachLongPressStart`|Fires as soon as the button is held down for 1 second.|
-|`attachDuringLongPress`|Fires periodically as long as the button is held down.|
-|`attachLongPressStop`|Fires when the button is released after a long hold.|
+| Attach Function         | Description                                            |
+| ----------------------- | ------------------------------------------------------ |
+| `attachClick`           | Fires as soon as a single click is detected.           |
+| `attachDoubleClick`     | Fires as soon as a double click is detected.           |
+| `attachPressStart`      | Fires as soon as the button is pressed down.           |
+| `attachLongPressStart`  | Fires as soon as the button is held down for 1 second. |
+| `attachDuringLongPress` | Fires periodically as long as the button is held down. |
+| `attachLongPressStop`   | Fires when the button is released after a long hold.   |
+
 
 ### Event Timing
 
@@ -97,30 +123,34 @@ the following functions to change the timing.
 click event is not attached, the library will assume a valid single click after one click duration,
 otherwise it must wait for the double click timeout to pass.
 
-|Function|Default (ms)|Description|
-|---|---|---|
-|`setDebounceTicks(int)`|`50`|Period of time in which to ignore additional level changes.|
-|`setClickTicks(int)`|`600`|Timeout used to distinguish single clicks from double clicks.|
-|`setPressTicks(int)`|`1000`|Duration to hold a button to trigger a long press.|
+| Function                | Default (ms) | Description                                                   |
+| ----------------------- | ------------ | ------------------------------------------------------------- |
+| `setDebounceTicks(int)` | `50`         | Period of time in which to ignore additional level changes.   |
+| `setClickTicks(int)`    | `600`        | Timeout used to distinguish single clicks from double clicks. |
+| `setPressTicks(int)`    | `1000`       | Duration to hold a button to trigger a long press.            |
+
 
 ### Additional Functions
 
 `OneButton` also provides a couple additional functions to use for querying button status:
 
-|Function|Description|
-|---|---|
-|`bool isLongPressed()`|Detect whether or not the button is currently inside a long press.|
-|`int getPressedTicks()`|Get the current number of milliseconds that the button has been held down for.|
+| Function                | Description                                                                    |
+| ----------------------- | ------------------------------------------------------------------------------ |
+| `bool isLongPressed()`  | Detect whether or not the button is currently inside a long press.             |
+| `int getPressedTicks()` | Get the current number of milliseconds that the button has been held down for. |
+
 
 ### `tick()` and `reset()`
 
 You can specify a logic level when calling `tick(bool)`, which will skip reading the pin and use
 that level instead. If you wish to reset the internal state of your buttons, call `reset()`.
 
+
 ## Troubleshooting
 
 If your buttons aren't acting they way they should, check these items:
 
 1. Check your wiring and pin numbers.
-1. Did you call `tick()` on each button instance in your loop?
-1. Did you alter your clock timers in any way without adjusting ticks?
+2. Did you call `tick()` on each button instance in your loop?
+3. Did you alter your clock timers in any way without adjusting ticks?
+