Before we do a 1.0 release, we should really document what we are commiting to. Change-Id: I44c62f9b1a35ace5dc7d963ab5bddc83fba4bce3