From 4a7855b27fed3911a7d56443bc548382bca25496 Mon Sep 17 00:00:00 2001
From: jdmedlock <jdmedlock@gmail.com>
Date: Tue, 5 Mar 2019 20:01:04 -0600
Subject: [PATCH] Feature: Add Bin2Dec application specification

Add Bin2Dec application specification

Resolves: N/a
See also: N/a
---
 Projects/Bin2Dec-App.md | 38 ++++++++++++++++++++++++++++++++++++++
 README.md               |  1 +
 2 files changed, 39 insertions(+)
 create mode 100644 Projects/Bin2Dec-App.md

diff --git a/Projects/Bin2Dec-App.md b/Projects/Bin2Dec-App.md
new file mode 100644
index 00000000..8a9e373d
--- /dev/null
+++ b/Projects/Bin2Dec-App.md
@@ -0,0 +1,38 @@
+# Bin2Dec
+
+Binary is the number system all digital computers are based on. 
+Therefore it's important for developers to understand binary, or base 2, 
+mathematics. The purpose of Bin2Dec is to provide practice and 
+understanding of how binary calculations.
+
+Bin2Dec allows the user to enter strings of up to 8 binary digits, 0's
+and 1's, in any sequence and then displays its decimal equivalent.
+
+This challenge requires that the developer implementing it follow these
+constraints:
+
+- Arrays may not be used contain the binary digits entered by the user
+- Determining the decimal equivalent of a particular binary digit in the
+sequence must be calculated using a single mathematical function, for
+example the natural logarithm. It's up to you to figure out which function
+to use.
+
+## User Stories
+
+-   [ ] User can enter up to 8 binary digits in one input field
+-   [ ] User must be notified if anything other than a 0 or 1 was entered.
+-   [ ] User views the results in a single output field containing the 
+decimal (base 10) equivalent of the the binary number that was entered
+
+## Bonus features
+
+-   [ ] User can enter a variable number of binary digits
+
+## Useful links and resources
+
+[Binary number system](https://en.wikipedia.org/wiki/Binary_number)
+
+## Example projects
+
+Try not to view this until you've developed your own solution:
+- [Binary to decimal conversion program for beginners](https://www.youtube.com/watch?v=YMIALQE26KQ)
diff --git a/README.md b/README.md
index c3e0adc0..8e26f3a8 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,7 @@ Each project has the following **features**:
 
 | Name                                                               |
 | ------------------------------------------------------------------ |
+| [Bin2Dec](./Projects/Bin2Dec-App.md)                               |
 | [Book Finder App](./Projects/Book-Finder-App.md)                   |
 | [Christmas Lights](./Projects/Christmas-Lights-App.md)             |
 | [Kudos Slackbot](./Projects/Kudos-Slackbot.md)                     |