Document Editions, Deprecation, and Version Page Labels (#846)

* Initial draft of collecting inline page roles for versions, deprecation, etc.

* Add Deprecated tag/role

* Add suggestions from Simon

Author: sarahlwelton

home/modules/contribute/pages/attributes-and-roles.adoc

@@ -1,4 +1,5 @@
 = Attributes and Roles
+:page-toclevels: 3
 
 Use attributes and roles to insert content or CSS styles into your pages. 
 
@@ -103,6 +104,58 @@ I'm a block with an assigned role!
 \----
 ----
 
+=== Inline Roles for Editions, Versions, and Deprecation
+
+Couchbase Documentation created inline page roles for marking sections of documentation as deprecated, for a specific Couchbase Server version, or for marking sections as applying to a specific product edition - similar to <<page-edition,the :page-edition: attribute>>. 
+
+You can use the following inline roles to mark sections of text in your documentation: 
+
+|==== 
+| Role | Example 
+
+a|
+[source,asciidoc]
+----
+[.edition]#{enterprise}#
+----
+a| [.edition]#{enterprise}# 
+
+This text applies to Couchbase Server Enterprise Edition 
+
+a| 
+[source,asciidoc]
+----
+[.edition]#{community}#
+----
+a| [.edition]#{community}# 
+
+This text applies to Couchbase Server Community Edition 
+
+a| 
+[source,asciidoc]
+----
+[.status]#Couchbase Server x.x.x#
+----
+a| [.status]#Couchbase Server 7.6.2#
+
+This text applies to Couchbase Server version 7.6.2 
+
+a| 
+[source,asciidoc]
+----
+[.deprecated]#Deprecated#
+----
+a| [.deprecated]#Deprecated#
+
+This text applies to a deprecated feature 
+
+|====
+
+The `#{enterprise}#` and `#{community}#` edition attributes are defined in the Antora playbook and automatically add a link to details about the different Couchbase Server editions. 
+
+When adding badges to text, try to always add the badge on a single line, by itself, following the heading of the section where it applies.
+Otherwise, place the badge as close to the edition, version, or deprecated content as possible. 
+
 === Page Roles
 
 Assigning a role to a page applies that role to the entire page, rather than a specific block or phrase.

home/modules/contribute/partials/available-attributes.adoc

@@ -64,7 +64,7 @@ For a page in another repository: `:page-aliases:7.6@server:develop:integrations
 
 When linking to a repository that has a version, you must specify which version in that repository redirects to your current page.
 
-| `:page-edition:`
+| [[page-edition]]`:page-edition:`
 | If you're writing content that only applies to a specific edition of Couchbase Server, usually the Enterprise Edition, use the `page-edition` attribute to add a badge to the page that indicates the Edition the content applies to.
 | `page-edition: Enterprise Edition`