TBR docs: a few followups to prep for release
Change-Id: Ic0675e71bbc540afd2d9d381aee55741d334be98
MultiPart: 1/3
diff --git a/concepts/syncbase-overview.md b/concepts/syncbase-overview.md
index 76db2d8..2f4ad18 100644
--- a/concepts/syncbase-overview.md
+++ b/concepts/syncbase-overview.md
@@ -25,8 +25,8 @@
- Open source reference implementation of Syncbase for developers who want
tight control over the data
-The initial version of Syncbase is ready for testing and evaluation by Vanadium
-trusted testers.
+The initial version of Syncbase is ready for testing and evaluation by early
+adopters - it is suitable for prototyping, but not for production applications.
This document presents an overview of the system. It is very light on
implementation details. Subsequent docs will contain those details.
@@ -77,8 +77,8 @@
streaming upload/download API rather than the all-at-once operations of the
structured data. Syncbase understands references to blobs in the structured
data, making it possible to implement automatic caching and garbage collection
-of the blobs. The blob reference's implicitly grant access to the blobs in a
-manner similar to a capability (see [blob references](#references)).
+of the blobs. Blob references implicitly grant access to blobs in a manner
+similar to a capability (see [blob references](#references)).
### Batches
diff --git a/contributing/README.md b/contributing/README.md
index ae49fd4..a3fe153 100644
--- a/contributing/README.md
+++ b/contributing/README.md
@@ -45,8 +45,7 @@
If you are developing on Darwin (OS X), you need to have the Xcode command
line tools installed. You can quickly install these in the terminal with:
-
- # Mac only prerequisite install
+ # Mac-only prerequisite install
xcode-select --install
The instructions on this page assume that the following software is installed and in your `PATH`:
@@ -308,8 +307,8 @@
branch.
3. Optional: Delete the feature branch once it has been submitted:
- git checkout master
- jiri cl cleanup <branch>
+ git checkout master
+ jiri cl cleanup <branch>
#### Useful shortcuts
diff --git a/glossary.md b/glossary.md
index cb57ac2..1da6517 100644
--- a/glossary.md
+++ b/glossary.md
@@ -372,10 +372,7 @@
## v23
The [atomic number of Vanadium][vanadium-element] is 23, which is the
-inspiration behind the `v23` shorthand for Vanadium. It is used broadly, from
-directory names to command-line flags and tools.
-
-See also: [v23 command-line tool](tools/v23.md), [Contribution instructions](community/contributing.md).
+inspiration behind the `v23` shorthand for Vanadium.
## vrpc
diff --git a/tools/jiri.md b/tools/jiri.md
index 6b9eb32..113d8e8 100644
--- a/tools/jiri.md
+++ b/tools/jiri.md
@@ -6,4 +6,4 @@
jiri help
-[contributing]: ../community/contributing.md
+[contributing]: ../contributing/README.md
diff --git a/tutorials/syncbase-user-guide.md b/tutorials/syncbase-user-guide.md
index ab86f66..9d2c08f 100644
--- a/tutorials/syncbase-user-guide.md
+++ b/tutorials/syncbase-user-guide.md
@@ -25,8 +25,8 @@
- Open source reference implementation of Syncbase for developers who want
tight control over the data
-The initial version of Syncbase is ready for testing and evaluation by Vanadium
-trusted testers.
+The initial version of Syncbase is ready for testing and evaluation by early
+adopters - it is suitable for prototyping, but not for production applications.
This document covers installation and basic usage. It should be enough for
developers to get started using Syncbase. For more details on the design, see
