Reword tag convention. refs #1508

[arvados.git] / doc / api / schema / Link.textile

diff --git a/doc/api/schema/Link.textile b/doc/api/schema/Link.textile
index 6156414301a6517282ff31218939f81a48759d53..66130b097c1324a6a847bd1cff225515a98433ec 100644 (file)
--- a/doc/api/schema/Link.textile
+++ b/doc/api/schema/Link.textile
@@ -76,11 +76,12 @@ table(table table-bordered table-condensed).
 
 h3. tag
 
-A **tag** link is a keyword string that identifies a group of collections.  A collection may be assigned multiple tags, and a tag will typically include many collections.
+A **tag** link describes an object using an unparsed plain text string. Tags can be used to annotate objects that are not editable, like collections and objects shared as read-only.
 
 table(table table-bordered table-condensed).
-|_. tail_type→head_type|_. name→head_uuid {properties}|_. Notes|
-|→Collection           | _tag name_ → _collection uuid_||
+|_. tail_type→head_type|_. name→head_uuid {properties}|
+|→Collection           | _tag name_ → _collection uuid_|
+|→Job                  | _tag name_ → _job uuid_|
 
 h3. human_trait