diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 55789d4db..b54b9487d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -13,7 +13,7 @@ when creating your pull request:
 3. Open the `AppResources.XX.resx` file for your newly created language and start translating the `<value>` tags for
    each `<data>` element. The `<data>` and `<comment>` properties should not be translated and remain in English.
 4. Repeat the same process for the store `COPY.md` and `CAPTIONS.md` files in `/store/apple` and `/store/google` by
-   creating a new folder for your language. Do not copy over the `assets` and `screenshots` folders to your new
+   creating a new folder for your language in each. Do not copy over the `assets` and `screenshots` folders to your new
    language. We will update these based on your translations provided in `CAPTIONS.md`. Finally, do not translate the
    titles in the markdown files (ex. `# Name` and `# Screenshot 1`). These are only for reference.
 5. If you have a Xamarin development environment setup, test your translations to make sure they look correct in the
@@ -22,7 +22,12 @@ when creating your pull request:
    If you are inable to accomedate the avaialable space for a particular translation, just let us know in your pull
    request comments. If you are unable to test your translations, just let us know in your pull request comments so
    that we can check it for you.
-6. Be sure to watch for [future changes](https://github.com/bitwarden/mobile/blob/master/src/App/Resources/AppResources.resx)
+6. Be sure to watch for [future changes](https://github.com/bitwarden/mobile/commits/master/src/App/Resources/AppResources.resx)
    to the `/src/App/Resources/AppResources.resx` file so that your translation will stay up to date.
 
 You can find an example of a proper translation pull request here: <https://github.com/bitwarden/mobile/pull/22>
+
+You can read more about localizing a Xamarin.Forms app here:
+<https://developer.xamarin.com/guides/xamarin-forms/advanced/localization/>
+
+TIP: If you have Visual Studio installed, it provides a nice tabular UI for editing `resx` XML files.
\ No newline at end of file
diff --git a/README.md b/README.md
index 079237a9f..851fefbf3 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,18 @@
 
 The bitwarden mobile application is written in C# with Xamarin Android, Xamarin iOS, and Xamarin Forms.
 
+# Build/Run
+
+**Requirements**
+
+- [Visual Studio w/ Xamarin -or- Xamarin Studio](https://store.xamarin.com/)
+
+By default the app is targeting the production API. If you are running the [Core](https://github.com/bitwarden/core) API locally,
+you'll need to switch the extension to target your local API. Open `src/App/Utilities/ApiHttpClient.cs` and set `BaseAddress` to your local
+API instance (ex. `new Uri("http://localhost:4000")`).
+
+After restoring the nuget packages, you can now build and run the app.
+
 # Contribute
 
 Code contributions are welcome! Visual Studio or Xamarin Studio is required to work on this project. Please commit any pull requests against the `master` branch.