From 5defc02b5650d2cca252978167881e73d0d70375 Mon Sep 17 00:00:00 2001
From: Peter <ple103@users.noreply.github.com>
Date: Wed, 7 Jun 2017 07:04:28 +1000
Subject: [PATCH] Add Android auto-fill guide and known issue articles (#20)

---
 .../known-issues/auto-fill-mobile-browser.md  | 18 ++++++++++
 _articles/misc/auto-fill-android.md           | 35 +++++++++++++++++++
 _categories/misc.md                           |  5 +++
 3 files changed, 58 insertions(+)
 create mode 100644 _articles/known-issues/auto-fill-mobile-browser.md
 create mode 100644 _articles/misc/auto-fill-android.md
 create mode 100644 _categories/misc.md

diff --git a/_articles/known-issues/auto-fill-mobile-browser.md b/_articles/known-issues/auto-fill-mobile-browser.md
new file mode 100644
index 00000000..2f23f475
--- /dev/null
+++ b/_articles/known-issues/auto-fill-mobile-browser.md
@@ -0,0 +1,18 @@
+---
+layout: article
+title: Can't auto-fill mobile browser
+categories: [Known Issues]
+featured: false
+popular: false
+tags: [mobile, browser, auto fill]
+---
+
+## Issue
+The bitwarden Auto-fill notification does not appear when I visit a login page or tap the password field of a login form.
+
+## Details
+This is a currently a known issue with the following browsers:
+* Firefox for Android
+* Samsung Internet Browser
+
+If auto-fill does not work and your browser is not listed above please report it at: <https://github.com/bitwarden/mobile/issues>
diff --git a/_articles/misc/auto-fill-android.md b/_articles/misc/auto-fill-android.md
new file mode 100644
index 00000000..1b70ea08
--- /dev/null
+++ b/_articles/misc/auto-fill-android.md
@@ -0,0 +1,35 @@
+---
+layout: article
+title: Auto-fill Android
+categories: [Misc]
+featured: false
+popular: false
+tags: [android, auto fill]
+---
+
+## Enabling the service
+1. Open the bitwarden app
+2. Tap **Tools > bitwarden Auto-fill Service**
+    - *Status Disabled* will appear
+3. Tap **OPEN ACCESSIBILITY SETTINGS**
+4. Locate **bitwarden** from the list and enable it
+
+Auto-fill is context-sensitive. This means that the bitwarden auto-fill icon, and notification will only appear when it detects a login form or when the password field is selected.
+
+## Testing auto-fill
+1. Open an app that has not been signed in to
+2. Tap the password box
+    - The bitwarden icon will appear in the notification bar
+3. Open the notification drawer and tap **bitwarden Auto-fill Service**
+    - Your vault will display all matching logins otherwise you may need to manually search for it
+4. Tap the appropriate login
+    - Your username and password will be auto-filled
+
+## Troubleshooting
+**The bitwarden Auto-fill Service keeps getting disabled**
+
+Android may turn off the bitwarden Auto-fill Service to optimize battery life. To resolve this you can either:
+- Tell Android to ignore battery optimization for the bitwarden; or
+- Manually turn on the bitwarden Auto-fill Service each time
+
+**[Can't auto-fill in my mobile browser](/article/auto-fill-mobile-browser)**
diff --git a/_categories/misc.md b/_categories/misc.md
new file mode 100644
index 00000000..0065da92
--- /dev/null
+++ b/_categories/misc.md
@@ -0,0 +1,5 @@
+---
+layout: category
+title: Misc
+featured: true
+---