Update the README for the new, easy install instructions.
authorRobert Sesek <rsesek@bluestatic.org>
Sun, 7 Oct 2012 14:30:50 +0000 (10:30 -0400)
committerRobert Sesek <rsesek@bluestatic.org>
Sun, 7 Oct 2012 14:30:50 +0000 (10:30 -0400)
README.md

index e899cce46e3c9c49b2528909d731bffb0eb62d00..015aed35f0bcf1c083329fbaed2aec26adca017c 100644 (file)
--- a/README.md
+++ b/README.md
@@ -7,26 +7,15 @@ home media center, allowing you to manage your files from your couch.
 ## Installation
 
 Installation requires the [Go runtime](http://golang.org/doc/install) because
 ## Installation
 
 Installation requires the [Go runtime](http://golang.org/doc/install) because
-there is no binary distribution yet.
+there is no binary distribution yet. To install, use the go command:
 
 
-After installing Go, clone this repository and type `make`:
+    $ go get https://github.com/rsesek/armadillo
 
 
-    $ git clone https://github.com/rsesek/armadillo
-    $ make
-
-    # Or to minify the JavaScript:
-
-    $ make release
-
-If you have Java installed, you can use the
-[Closure Compiler](https://developers.google.com/closure/compiler/) to minify
-and compile the frontend JavaScript code by typing `make release`.
-
-After building, you will have a binary named `armadillo`.
+After building, you will have a binary named `armadillo` in your $GOBIN.
 
 ## Configuration
 
 
 ## Configuration
 
-Armadillo can either be configured using command line parameters, or via a JSON
+Armadillo can either be configured using command line parameters or via a JSON
 configuration file in `~/.armadillo`. The two important directives are
 "JailRoot" and "Port":
 
 configuration file in `~/.armadillo`. The two important directives are
 "JailRoot" and "Port":
 
@@ -39,13 +28,13 @@ configuration file in `~/.armadillo`. The two important directives are
       "Port": 8084
     }
 
       "Port": 8084
     }
 
-You can specify these values on the command line. See `armadillo -help` for
+You can also specify these values on the command line. See `armadillo -help` for
 more details.
 
 ## Security
 
 Armadillo does not fork itself into a daemon process; it runs under the user
 more details.
 
 ## Security
 
 Armadillo does not fork itself into a daemon process; it runs under the user
-who started t. This is because it needs read and write permission to the file
+who started it. This is because it needs read and write permission to the file
 system.
 
 **NOTE: Armadillo provides no form of authorization or authentication. It is
 system.
 
 **NOTE: Armadillo provides no form of authorization or authentication. It is
@@ -84,3 +73,23 @@ Then type:
 
 And armadillo will start serving with the configuration file you specified in
 the plist. The next time you log in, armadillo will run automatically.
 
 And armadillo will start serving with the configuration file you specified in
 the plist. The next time you log in, armadillo will run automatically.
+
+## Contributing
+
+Contributions to armadillo are welcome. There is a Makefile used for local
+development builds. There are four targets of interest to contributors:
+
+* `backend`: This target merely runs the go build command in the local directory.
+* `frontend`: Generates the frontend "binary" armadillo.js by referencing and
+  loading all the other frontend files. This is used for debugging and iterative
+  development.
+* `all`: The default target, which executes `backend` and `frontend`.
+* `release`: Like `all`, but rather than generating a frontend binary for
+  debugging, this runs the frontend code through the
+  [Closure Compiler](https://developers.google.com/closure/compiler/) to minify
+  and optimize it.
+
+All other targets are reserved for the project maintainer.
+
+Patches can be distributed via pull requests, if your history and commit
+messages are clean.  Please also follow existing code style conventions.