add more docs

Author: harrysarson

Diff for: CONTRIBUTING

@@ -0,0 +1,17 @@
+Quick Installation Guide for musl libc
+======================================
+
+
+Contributions are very welcome, currently we do not have any explicit
+guidelines.
+
+
+Acknowledgements
+----------------
+
+The vast majority of the code in another-elm is derived from the relavant elm/*
+packages.
+
+The documentation of another-elm is inspired by that of [musl].
+
+[musl]: https://musl.libc.org/

Diff for: INSTALL

@@ -0,0 +1,40 @@
+Quick Installation Guide for musl libc
+======================================
+
+
+another-elm comes with a wrapper script of the same name. The wrapper should be
+a drop in replacement for the offical elm compiler.
+
+
+Prerequisites
+-------------
+
+The wrapper script is written in python, a non-eol needs to be installed to run
+the wrapper. The official elm compiler must also be installed.
+
+
+Supported Elm Versions
+----------------------
+
+We support the latest version of elm, older versions may be supported but that
+support may be removed at any time.
+
+
+Build and Installation Procedure
+--------------------------------
+
+To build and install another-elm:
+
+   sudo mkdir -p /opt/elm/
+   sudo chown $USER /opt/elm
+   git clone https://github.com/another-elm/std /opt/elm/std
+   sudo ln -s /opt/elm/std/tools/another-elm /usr/local/bin/another-elm
+
+
+Checking for Successful Installation
+------------------------------------
+
+Currently it is hard to work out if the installation worked correctly. In the
+future we will automate this. For now, here is a usefull test: if the compiler
+generates javascript contains "$elm$core$Platform$Raw$Scheduler" then
+another-elm has been correctly installed.

Diff for: README

@@ -1,9 +1,17 @@
-     another-elm/core
 
-Another implementation of the elm core library.
+     another-elm/std
+
+Another implementation of the elm standard libraries. Contributions are very
+welcome, currently we are aiming for maximum compatibility with the offical
+elm/* packages.
+
+See
+
+     ./NEWS:             To read about the development of this library
+     ./LICENSE:          For the BSD-3-Clause licence.
+     ./INSTALL:          For installation details.
+     ./CONTRIBUTING:     To get involved and for our acknowledgements.
 
-To read about the development of this library see ./NEWS which hopefully
-chronicles the most important developments.
 
 We will leave you with Tom Odell's `Another elm':