Add comments

Author: jazairi

app/views/thirdiron/browzine.html.erb

@@ -1,3 +1,8 @@
+<%# Dedicated Browzine endpoint response for journal records.
+    Rendered when: A Primo journal result with ISSN triggers a Browzine API lookup via /browzine?issn=X&full_record_url=Y
+    Use case: Primary fulfillment source for journal articles (via trigger_browzine partial from _result_primo.html.erb)
+    Returns: Browzine link + optional "Full-text options" button (links to Primo record)
+%>
 <% if ThirdIron.enabled? && @browzine.present? && @browzine[:browzine_link].present? %>
   <% if @full_record_url.present? %>
     <%= link_to 'Full-text options', @full_record_url, class: 'button libkey-link', data: { matomo_seen: "Results, Full-text Options Link Seen, Tab: {{getActiveTabName}}", matomo_click: "Results, Full-text Options Link Engaged, Link: {{getElementText}}", content_piece: 'Full-text options' } %>

app/views/thirdiron/libkey.html.erb

@@ -13,6 +13,12 @@
     <%= link_to( @libkey[:best_integrator_link][:text], @libkey[:best_integrator_link][:link], class: 'button libkey-link', data: { matomo_seen: "Results, LibKey Link Seen, Tab: {{getActiveTabName}}", matomo_click: "Results, LibKey Link Engaged, Link: {{getElementText}}", content_piece: @libkey[:best_integrator_link][:text] } ) %>
   <% end %>
 
+  <%# Browzine link returned as part of LibKey fulfillment response.
+      Rendered when: LibKey API includes a browzine_link in its response
+      Use case: Secondary fulfillment option alongside PDF, HTML, or other direct links from LibKey
+      Note: Different from dedicated browzine.html.erb which is called directly for journals.
+            LibKey Browzine link appears when looking up DOI/PMID fulfillment (articles, etc.)
+  %>
   <%# Display browzine link if available. This should always display if we have it regardless of other links. %>
   <% if @libkey[:browzine_link].present? %>
     <div class="libkey-actions">