fix links

Change-Id: I7a650f1ace765b1d2fe61933f422ee5bdb572f1a
diff --git a/ b/
index 280c985..54aee30 100644
--- a/
+++ b/
@@ -1,3 +1,20 @@
+ Copyright 2018 The CUE Authors
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ See the License for the specific language governing permissions and
+ limitations under the License.
 # The CUE Configuration Language
 _Configure, Unify, Execute_
@@ -8,22 +25,24 @@
 CUE is a constrained-based language.
 Constraints provide a powerful yet simple alternative
 to inheritance, a common source of complexity
-with other languages.
-The CUE tooling also provides powerful integrated scripting
-aimed at improving the overall experience of putting
-configurations to good use.
+with other configuration languages.
+The CUE tooling also provides integrated declarative scripting
+aimed at simplifying putting configurations to good use while
+giving static analyis tools maximum domain knowledge.
 Some highlights:
 - JSON superset: get started quickly
 - convert existing YAML and JSON
-- arbitrary-precision arithmetic
-- reformatter
+- declarative scripting
 - automatically simplify configurations
-- powerful scripting
+- formatter
+- arbitrary-precision arithmetic
 - rich APIs designed for automated tooling
 - a formalism conducive to automated reasoning
 - generate CUE templates from source code
+- generate source code from CUE configurations (TODO)
 ### Download and Install
@@ -38,32 +57,32 @@
 This will install the `cue` command line tool.
-For more details see [Installing CUE][./doc/].
+For more details see [Installing CUE](./doc/
 ### Learning CUE
 A demonstration of how to convert and restructure and existing
 set of Kubernetes configurations is available in
-[written form][./doc/demo/kubernetes/] or as
+[written form](./doc/examples/kubernetes/ or as
 ### References
-- [Language Specification][./doc/ref/]: official CUE Language specification.
+- [Language Specification](./doc/ref/ official CUE Language specification.
 - [API]( the API on
 - [Builtin packages]( builtins available from CUE programs
-- [`cue` Command line reference][./doc/cmd/]: the `cue` command
+- [`cue` Command line reference](./doc/cmd/ the `cue` command
 ### Contributing
 Our canonical Git repository is located at
-To contribute, please read the [Contribution Guidelines][./]
+To contribute, please read the [Contribution Guidelines](./
 ##### Note that we do not accept pull requests and that we use the issue tracker for bug reports and proposals only.