[UR] Refactor script and rst template

Author: Petr Vesely

scripts/templates/exp_feat.rst.mako

@@ -4,14 +4,13 @@
     X=x.upper()
 %>
 </%text>
-.. _experimental-${name}
+.. _experimental-${name}:
 
 ================================================================================
 ${" ".join(name.split("-")).title()}
 ================================================================================
 
-
-.. warning:
+.. _warning:
 
     Experimental features:
 
@@ -21,8 +20,63 @@ ${" ".join(name.split("-")).title()}
     *   Do not require conformance testing of their own additions.
 
 
-.. todo::
+--------------------------------------------------------------------------------
+Terminology
+--------------------------------------------------------------------------------
+If your experimental feature introduces a new concept or terminoloyg. Please 
+provide a detailed explanation in this section. If this does not apply to your 
+feature you may freely delete this section.
+
+--------------------------------------------------------------------------------
+Motivation
+--------------------------------------------------------------------------------
+In this section you *must* justify your motivation for adding this experimental
+feature. You should also state at least one adapter upon which this feature can 
+be supported.
+
+--------------------------------------------------------------------------------
+API
+--------------------------------------------------------------------------------
+In this section you *must* list all additions your experimental feature will 
+make to the Unified Runtime specification. If your experimental feature does not
+include additions from one or more of the sections listed below, you may freely 
+remove them.
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Macros
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* <%text>${x}</%text>_EXP_MACRO
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Enums
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* <%text>${x}</%text>_exp_enum_t
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Structs
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* <%text>${x}</%text>_exp_struct_t 
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* <%text>${x}</%text>FunctionExp
+
+--------------------------------------------------------------------------------
+Changelog
+--------------------------------------------------------------------------------
+
++-----------+------------------------+
+| Revision  | Changes                |
++===========+========================+
+| 1.0       | Intial Draft           |
++-----------+------------------------+
+
+--------------------------------------------------------------------------------
+Contributors
+--------------------------------------------------------------------------------
+Please list all people who wish to be credited for contribution to this 
+experimental feature.
 
-    In the following sections you should explain and document the motivation of 
-    the experimental feature, the additions made to the specification along with
-    its valid usage.
+* Contributor One `contrib.one@email.com <contrib.one@email.com>`_
+* Contributor Two `contrib.two@email.com <contrib.one@email.com>`_

scripts/templates/exp_feat.yml.mako

@@ -17,6 +17,3 @@ import datetime
 type: header
 desc: "Intel $OneApi Unified Runtime Experimental APIs for ${" ".join(name.split("-")).title()}"
 ordinal: "99"
---- #--------------------------------------------------------------------------
-## TODO - Add you experimental feature additions here
-##      - refer to YaML.md for the syntax defintion