From 430d4e36e5401eac69d12d739bcb79a727fba5f4 Mon Sep 17 00:00:00 2001
From: cjsha <cs@open-ephys.org>
Date: Tue, 29 Oct 2024 01:06:04 -0400
Subject: [PATCH 1/2] Add badges for configuration/acquisition properties

---
 template/ManagedReference.extension.js        | 6 +++++-
 template/partials/propertyTables.tmpl.partial | 2 ++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/template/ManagedReference.extension.js b/template/ManagedReference.extension.js
index 2c162f1..aec591f 100644
--- a/template/ManagedReference.extension.js
+++ b/template/ManagedReference.extension.js
@@ -28,6 +28,8 @@ function processChildProperty(child, sharedModel) {
   const enumFields = sharedModel[`~/api/${child.syntax.return.type.uid}.yml`]?.type === 'enum' ?
     extractEnumData(sharedModel[`~/api/${child.syntax.return.type.uid}.yml`]) :
     [];
+    const acquisition = child?.attributes.some(attribute => attribute.type === 'System.ComponentModel.CategoryAttribute' && attribute?.arguments[0].value === 'Acquisition');
+    const configuration = child?.attributes.some(attribute => attribute.type === 'System.ComponentModel.CategoryAttribute' && attribute?.arguments[0].value === 'Configuration');
   return {
     'name': child.name[0].value,
     'type': child.syntax.return.type.specName[0].value,
@@ -35,7 +37,9 @@ function processChildProperty(child, sharedModel) {
       'text': addCodeTag([child.summary, child.remarks].join('')),
       'hasEnum': enumFields.length > 0,
       'enum': enumFields,
-    }
+    },
+    'configuration': configuration,
+    'acquisition': acquisition
   }
 }
 
diff --git a/template/partials/propertyTables.tmpl.partial b/template/partials/propertyTables.tmpl.partial
index 3be3754..50bc230 100644
--- a/template/partials/propertyTables.tmpl.partial
+++ b/template/partials/propertyTables.tmpl.partial
@@ -1,6 +1,8 @@
 <tr>
   <td style = "white-space: nowrap;">
     <code>{{{name}}}</code>
+    {{#acquisition}}<div style="padding-top: 0.5rem"><small class="mb-3 px-2 py-1 fw-semibold text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-2">acquisition</small></div>{{/acquisition}}
+    {{#configuration}}<div style="padding-top: 0.5rem"><small class="mb-3 px-2 py-1 fw-semibold text-warning-emphasis bg-warning-subtle border border-warning-subtle rounded-2">configuration</small></div>{{/configuration}}
   </td>
   <td style = "white-space: nowrap;">
     {{{type}}}

From 06eeea2e64fd6fa5e38982444800dd57081ac5f0 Mon Sep 17 00:00:00 2001
From: cjsha <cs@open-ephys.org>
Date: Tue, 29 Oct 2024 13:46:04 -0400
Subject: [PATCH 2/2] Add references to badges

---
 .../getting-started/property-categories.md    | 13 +++++++++---
 template/partials/propertyTables.tmpl.partial | 20 +++++++++++++++++--
 2 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/articles/getting-started/property-categories.md b/articles/getting-started/property-categories.md
index 8942806..b819365 100644
--- a/articles/getting-started/property-categories.md
+++ b/articles/getting-started/property-categories.md
@@ -5,8 +5,15 @@ title: Property Categories
 
 There are specific categories of properties that define when an operator's properties can be modified. 
 
-`Configuration` properties only have effect when a workflow is started and are used to initialize the hardware state. If they are changed while a workflow is running they will have no effect.
+<span class="badge bg-warning-subtle border border-warning-subtle text-warning-emphasis rounded-pill"
+id="configuration">configuration</span> properties have an effect on hardware when a workflow is started and are used to
+initialize the hardware state. Even if they are changed while a workflow is running, they will not have an effect until
+the workflow is restarted.
 
-`Acquisition` properties can be manipulated when the workflow is running and will have an immediate effect on hardware. For instance stimulus waveform parameters can be modified in real-time and sent to the device multiple times while the workflow is running to shape stimulation patterns.
+<span class="badge bg-primary-subtle border border-primary-subtle text-primary-emphasis rounded-pill"
+id="acquisition">acquisition</span> properties have an immediate effect on hardware when the workflow is running. For
+instance, stimulus waveform properties can be dynamically modified according to parameters in your workflow.
 
-`Devices` properties refer to the individual devices available within a particular aggregate operator. Aggregate operators include <xref:OpenEphys.Onix1.ConfigureHeadstage64>, <xref:OpenEphys.Onix1.ConfigureBreakoutBoard>, and more. Explore other available options under the [aggregate configuration operators](xref:configure) page.
\ No newline at end of file
+`Devices` properties refer to the individual devices available within a particular aggregate operator. Aggregate
+operators include <xref:OpenEphys.Onix1.ConfigureHeadstage64>, <xref:OpenEphys.Onix1.ConfigureBreakoutBoard>, and more.
+Explore other available options under the [aggregate configuration operators](xref:configure) page.
\ No newline at end of file
diff --git a/template/partials/propertyTables.tmpl.partial b/template/partials/propertyTables.tmpl.partial
index 50bc230..1be5152 100644
--- a/template/partials/propertyTables.tmpl.partial
+++ b/template/partials/propertyTables.tmpl.partial
@@ -1,8 +1,24 @@
 <tr>
   <td style = "white-space: nowrap;">
     <code>{{{name}}}</code>
-    {{#acquisition}}<div style="padding-top: 0.5rem"><small class="mb-3 px-2 py-1 fw-semibold text-primary-emphasis bg-primary-subtle border border-primary-subtle rounded-2">acquisition</small></div>{{/acquisition}}
-    {{#configuration}}<div style="padding-top: 0.5rem"><small class="mb-3 px-2 py-1 fw-semibold text-warning-emphasis bg-warning-subtle border border-warning-subtle rounded-2">configuration</small></div>{{/configuration}}
+      {{#acquisition}}
+        <div>
+          <a class="xref" href="~/articles/getting-started/property-categories.html#acquisition">
+            <button class="badge bg-primary-subtle border border-primary-subtle text-primary-emphasis rounded-pill">
+              acquisition
+            </button>
+          </a>
+        </div>
+      {{/acquisition}}
+      {{#configuration}}
+        <div>
+          <a class="xref" href="~/articles/getting-started/property-categories.html#configuration">
+            <button class="badge bg-warning-subtle border border-warning-subtle text-warning-emphasis rounded-pill">
+              configuration 
+            </button>
+          </a>
+        </div>
+      {{/configuration}}
   </td>
   <td style = "white-space: nowrap;">
     {{{type}}}