summaryrefslogtreecommitdiff
path: root/exercism/emacs-lisp/roman-numerals/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'exercism/emacs-lisp/roman-numerals/README.md')
-rw-r--r--exercism/emacs-lisp/roman-numerals/README.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/exercism/emacs-lisp/roman-numerals/README.md b/exercism/emacs-lisp/roman-numerals/README.md
new file mode 100644
index 0000000..6a95273
--- /dev/null
+++ b/exercism/emacs-lisp/roman-numerals/README.md
@@ -0,0 +1,60 @@
+# Roman Numerals
+
+Welcome to Roman Numerals on Exercism's Emacs Lisp Track.
+If you need help running the tests or submitting your code, check out `HELP.md`.
+
+## Instructions
+
+Write a function to convert from normal numbers to Roman Numerals.
+
+The Romans were a clever bunch. They conquered most of Europe and ruled
+it for hundreds of years. They invented concrete and straight roads and
+even bikinis. One thing they never discovered though was the number
+zero. This made writing and dating extensive histories of their exploits
+slightly more challenging, but the system of numbers they came up with
+is still in use today. For example the BBC uses Roman numerals to date
+their programmes.
+
+The Romans wrote numbers using letters - I, V, X, L, C, D, M. (notice
+these letters have lots of straight lines and are hence easy to hack
+into stone tablets).
+
+```text
+ 1 => I
+10 => X
+ 7 => VII
+```
+
+There is no need to be able to convert numbers larger than about 3000.
+(The Romans themselves didn't tend to go any higher)
+
+Wikipedia says: Modern Roman numerals ... are written by expressing each
+digit separately starting with the left most digit and skipping any
+digit with a value of zero.
+
+To see this in practice, consider the example of 1990.
+
+In Roman numerals 1990 is MCMXC:
+
+1000=M
+900=CM
+90=XC
+
+2008 is written as MMVIII:
+
+2000=MM
+8=VIII
+
+See also: http://www.novaroma.org/via_romana/numbers.html
+
+## Source
+
+### Contributed to by
+
+- @bakhti
+- @canweriotnow
+- @vermiculus
+
+### Based on
+
+The Roman Numeral Kata - http://codingdojo.org/cgi-bin/index.pl?KataRomanNumerals \ No newline at end of file