Add deprecation warnings for V1 API

Add warnings to the documentation for users and to the
source for developers.

Change-Id: Ic4695a8d1e4d2bc2d53b0bb69806c933f1b672aa
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>
Merge "Add deprecation warnings for V1 API"