README: add note on Stability. Also, TOC for impl.md

fkorotkov · Oct 2, 2017 · f09c8ae · f09c8ae
1 parent 3bd5d1b
commit f09c8ae
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -116,6 +116,13 @@ If the copyright holder for your contribution has already completed
 the agreement in connection with another Google open source project,
 it does not need to be completed again.
 
+### Stability
+
+We reserve the right to make breaking language and API changes at this
+stage in the project, although we will endeavor to keep them to a minimum.
+Once the project has its long-term name (see below) and location, and
+the Bazel team has finalized the version 1 language specification,
+we will be more rigorous with interface stability.
 
 ### Credits
 

diff --git a/doc/impl.md b/doc/impl.md
@@ -4,7 +4,14 @@
 This document describes some of the design choices of the Go
 implementation of Skylark.
 
-[TOC]
+
+  * [Scanner](#scanner)
+  * [Parser](#parser)
+  * [Resolver](#resolver)
+  * [Evaluator](#evaluator)
+    * [Data types](#data-types)
+    * [Testing](#testing)
+
 
 ## Scanner