Access.md added.
Minor changes and fixes.
Redefine Actors; use consistently; Capitalize k8s.
Defer details of Authorization to a separate doc.
Separate userAccount and auth-method.  Add UID.
More Goals and less impl details of Authn.
Expanded discussion of projects in the REST API based on feedback.
Add the resource version to api.*List items from etcd

Allows clients to watch more easily (can invoke Get, then
Watch).
Describe some ecosystem projects around Kube
Invert api and api/v1beta1 dependencies

This is some cleanup that has been needed for a while.
There's still one more step that could usefully be done, which is to
split up our api package into the part that provides the helper
functions and the part that provides the internal types. That can come
later.

The v1beta1 package is now a good example of what an api plugin should
do to version its types.
Merge pull request #1099 from smarterclayton/return_resource_version_on_list

Add the resource version to api.*List items from etcd
Merge pull request #1106 from smarterclayton/describe_ecosystem_projects

Describe some ecosystem projects around Kube
Rename `output/` directory to `_output/`

go build ./... will ignore any directory starting with an underscore.
Remove dead code now that we are using godep.
Only build pause.go under linux.

This makes `godep go build ./...` work.
Merge pull request #1119 from jbeda/rename_output

Make `godep go build ./...` work
Add a Makefile

This is a very simple Makefile that just passes through to the current hack/*
scripts.  Only "make", "make test", and "make clean" are supported for now.
Merge pull request #1117 from lavalamp/fixApi

Invert api and api/v1beta1 dependencies
Merge pull request #1093 from thockin/Makefile2

Add a Makefile
Suppress non-error output of `systemctl enable`

The `systemctl enable` command ordinarily prints the `ln` command used
to enable the unit to stderr, but that's not ideal in the vagrant setup
because it gets printed in red, which should be reserved for errors, but
it's not a real error.

Set an environment variable to raise the log level to prevent `info`
messages from being printed to stderr (as they are not actually errors.)

I looked into the `systemctl` calls happening from the Salt setup script
to understand why they were not going to stderr, and it turns out the
Salt script will redirect all messages to stdout so they will all be
green regardless...

Tested:
- Started a fresh Vagrant cluster, confirmed no red messages in output
  when creating the cluster successfully. Successfully started nginx
  through Kubernetes using cluster/kubecfg.sh.
- Confirmed that the salt-api service was up after `vagrant up`:
  $ vagrant ssh master -c 'systemctl status salt-api.service'
  salt-api.service - The Salt API
     Loaded: loaded (/usr/lib/systemd/system/salt-api.service; enabled)
     Active: active (running) since Fri 2014-08-29 23:19:47 UTC; 11min ago
   Main PID: 2090 (salt-api)
     CGroup: /system.slice/salt-api.service
             +-2090 /usr/bin/python /usr/bin/salt-api
             +-2110 /usr/bin/python /usr/bin/salt-api

Signed-off-by: Filipe Brandenburger <filbranden@google.com>
Add support for -version=raw to print the Go version.Info

This can be helpful to print the internal fields of the version
information that will contain more details about the git tree than the
short -version output will.

Tested:
- Tested getting the raw version:
  $ _output/go/bin/kubecfg -version=raw
  version.Info{Major:"0", Minor:"1+", GitVersion:"v2.2.1-33-gdc4becd9765393", GitCommit:"dc4becd9765393fa05a3eb06f6af9e00068fe0c5", GitTreeState:"dirty"}

- Tested getting the simple version:
  $ _output/go/bin/kubecfg -version
  Kubernetes version 0.1+, build dc4becd9765393fa05a3eb06f6af9e00068fe0c5

- Tested getting the help output:
  $ _output/go/bin/kubecfg 2>&1 | grep -- -version
    -version=false: Print version information and quit

- Made sure -version=true and -version=false works, that -version with
  an invalid argument works as expected (prints usage help) and that
  -version followed by space will not try to use the next word as its
  argument (i.e. `-version raw` prints the version but not the raw one.)

Signed-off-by: Filipe Brandenburger <filbranden@google.com>