From 9a7ce465b06462443ee82e8418f3c070de080ab2 Mon Sep 17 00:00:00 2001
From: erdgeist <erdgeist@erdgeist.org>
Date: Sun, 5 Jul 2026 21:52:11 +0200
Subject: Surface node-kind conventions in the admin UI

nodes#new: each kind's radio button now shows a label plus a smaller,
muted .field_hint explaining what happens automatically (parent,
tags, template) - previously a single undifferentiated string mixing
a short label with a long parenthetical, cluttering the smaller kinds
(erfa/chaostreff) worst. Title field gets the same hint treatment,
telling editors up front that the slug is auto-generated and where to
adjust it later - the previous silence here meant editors only
discovered slug generation after already committing to a title, with
no visible way to fix it.

New "Resulting path" row live-previews the full URL (origin + kind's
path prefix + a debounced call to the new parameterize_preview route,
reusing the exact same slug_for helper "create" now calls, so the
preview can never diverge from what actually gets created) as the
editor types, plus a copy-to-clipboard button. For "generic", the
prefix comes from whichever parent gets chosen via the search widget,
not the registry - parent_search.link_closure now stashes the chosen
node's unique_name as a data attribute for exactly this.

New read-only admin/conventions view dumps the NODE_KINDS registry as
a reference table for whoever's confused later about how a given kind
behaves - deliberately just renders the same label/hint text used on
nodes#new rather than re-describing parent/tags/template separately,
since decomposing the parent Proc would mean either invoking it
(Update's has a real side effect - creates the year folder) or
re-stating its logic a second time in a different shape, either of
which risks drifting from the actual behavior.

nodes#edit's Template field gets a one-line hint noting the value may
already be pre-filled based on how the node was created - the one
place the previous commit's new inheritance mechanism actually
surfaces on this view.
---
 app/helpers/application_helper.rb |  4 ++++
 app/views/nodes/edit.html.erb     |  5 ++++-
 app/views/nodes/new.html.erb      | 34 +++++++++++++++++++---------------
 3 files changed, 27 insertions(+), 16 deletions(-)

(limited to 'app')

diff --git a/app/helpers/application_helper.rb b/app/helpers/application_helper.rb
index 0be66e9..87aa82c 100644
--- a/app/helpers/application_helper.rb
+++ b/app/helpers/application_helper.rb
@@ -11,4 +11,8 @@ module ApplicationHelper
       end
     end
   end
+
+  def resolve_kind_text(value)
+    value.respond_to?(:call) ? value.call : value
+  end
 end
diff --git a/app/views/nodes/edit.html.erb b/app/views/nodes/edit.html.erb
index 31f585c..2d0edc1 100644
--- a/app/views/nodes/edit.html.erb
+++ b/app/views/nodes/edit.html.erb
@@ -44,7 +44,10 @@
     <div class="node_content"><%= d.datetime_select :published_at, :value => @draft.published_at %></div>
 
     <div class="node_description">Template</div>
-    <div class="node_content"><%= d.select :template_name, custom_page_templates, {:prompt => 'Select Template'} %></div>
+    <div class="node_content">
+    <%= d.select :template_name, custom_page_templates, {:prompt => 'Select Template'} %>
+    <span class="field_hint">Set automatically based on how this node was created - change it if needed.</span>
+    </div>
 
     <div class="node_description">Author</div>
     <div class="node_content"><%= d.select :user_id, user_list %></div>
diff --git a/app/views/nodes/new.html.erb b/app/views/nodes/new.html.erb
index 028d727..f557454 100644
--- a/app/views/nodes/new.html.erb
+++ b/app/views/nodes/new.html.erb
@@ -13,27 +13,23 @@
   <tr>
     <td class="description">Type</td>
     <td>
-      <div>
-        <%= radio_button_tag :kind, "top_level" %>
-        Top Level
-      </div>
-      <p>
-        <%= radio_button_tag :kind, "generic", :selected => true %>
-        Generic ( can be created anywhere )
-      </p>
-      <p>
-        <%= radio_button_tag :kind, "update" %>
-        Update ( is automatically created in /updates/<%= Time.now.year.to_s %>/ and gets tag "update" )
-      </p>
+    <% CccConventions::NODE_KINDS.each do |kind, config| %>
       <p>
-        <%= radio_button_tag :kind, "press_release" %>
-        Pressemitteilung ( is automatically created in /updates/<%= Time.now.year.to_s %>/ and gets tags "update, pressemitteilung" )
+        <%= radio_button_tag :kind, kind, kind == "generic",
+          data: { path_prefix: resolve_kind_text(config[:path_prefix]) } %>
+        <%= resolve_kind_text(config[:label]) %>
+        <% if config[:hint] %>
+          <span class="field_hint"><%= resolve_kind_text(config[:hint]) %></span>
+        <% end %>
       </p>
+    <% end %>
     </td>
   </tr>
   <tr>
     <td class="description">Title</td>
-    <td><%= text_field_tag :title %></td>
+    <td><%= text_field_tag :title %>
+    <span class="field_hint">A URL slug will be generated from this automatically. You can review or adjust it afterward under the "metadata" section's Slug field.</span>
+    </td>
   </tr>
   <tr id="parent_search_field">
     <td class="description">Parent</td>
@@ -45,6 +41,14 @@
       </div>
     </td>
   </tr>
+  <tr>
+  <td class="description">Resulting path</td>
+  <td>
+    <span id="resulting_path">—</span>
+    <button type="button" id="copy_resulting_path" class="unselected">copy</button>
+    <span class="field_hint">This preview updates as you type. The final path can still be changed afterward by editing the title (for the last segment) or moving the node to a different parent (for everything before it).</span>
+  </td>
+  </tr>
   <tr>
     <td></td>
     <td class="right"><%= submit_tag "Create" %></td>
-- 
cgit v1.3