IEEE sponsor: metanorma/metanorma-ieee#150

author/ieee/ref/document-attributes.adoc

@@ -369,6 +369,39 @@ White papers require personal authors to be specified, as follows:
 * `:givenname:`, `:givenname_2:`, `:givenname_3:`: Given name of personal authors
 * `:contributor-position:`, `:contributor-position_2:`, `:contributor-position_3:`: Job title of personal authors
 
+=== Sponsors
+
+The sponsoring bodies, if any, are indicated through the `:sponsor:` and `:sponsor-subdivision:`
+attributes. As with other author values, multiple instances of sponsoring organisations and their
+subdivisions are indicated as `:sponsor_2:` and `:sponsor-subdivision_2:`, `:sponsor_3:` and `:sponsor-subdivision_3:`, etc.
+
+The values of `:sponsor-subdivision_{i}:` in turn
+can be multiple (semicolon-delimited: processed via CSV, recognising quote marks),
+and they can also be hierarchical, with multiple levels of subdivision (comma-delimited,
+from larger to smaller) [added in /~https://github.com/metanorma/metanorma-standoc/releases/tag/v2.8.3];
+the different hierarchical levels can optionally be prefixed with type and a colon.
+On the front line, if it is a sponsor, "IEEE" is prefixed to the first subdivision, rather than being rendered on a separate line.
+
+The following is an example of how two divisions of the IEEE are indicated as sponsoring the document:
+
+[source,adoc]
+----
+:sponsor: IEEE
+:sponsor-subdivision: Power & Energy Society, Power System Communications Committee; Communications Society, Standards Committee
+----
+
+rendered as:
+
+____
+Sponsored by the +
+*Power System Communications Committee* +
+of the +
+*IEEE Power & Energy Society* +
+and the +
+*Standards Committee* +
+of the +
+*IEEE Communications Society*
+____
 
 == Visual appearance