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.

5 files changed, 40 insertions, 16 deletions

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>
@@ -46,6 +42,14 @@
     </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>
   </tr>
diff --git a/config/routes.rb b/config/routes.rb
index cf4733c..6c07414 100644
--- a/config/routes.rb
+++ b/config/routes.rb
@@ -59,6 +59,7 @@ Cccms::Application.routes.draw do
     match 'admin'        => 'admin#index',      :as => :admin,        :via => :get
     match 'admin/search' => 'admin#search',     :as => :admin_search, :via => :get
     match 'admin/menu_search' => 'admin#menu_search', :as => :admin_menu_search, :via => :get
+    match 'admin/conventions' => 'admin#conventions', :as => :admin_conventions, :via => :get
     match 'search'       => 'search#index',     :as => :search,       :via => :get
 
     resources :users
diff --git a/public/stylesheets/admin.css b/public/stylesheets/admin.css
index a02bd61..f240bb2 100644
--- a/public/stylesheets/admin.css
+++ b/public/stylesheets/admin.css
@@ -508,6 +508,14 @@ table tr.header {
   text-align: left;
 }
 
+.field_hint {
+  display: block;
+  margin-top: 2px;
+  font-size: 0.75rem;
+  color: #969696;
+  padding-bottom: 4px;
+}
+
 #search_widget {
   position: absolute;
   top: 20px;
@@ -527,18 +535,21 @@ table tr.header {
   font-size: 18px;
 }
 
+#menu_search_results p,
 #search_results p {
   margin: 0;
   padding: 4px 4px 0 4px;
   border-bottom: 1px solid #e8e8e8;
 }
 
+#menu_search_results p a,
 #search_results p a {
   display: block;
   font-weight: bold;
   font-size: 0.95rem;
 }
 
+#menu_search_results p span.result_path,
 #search_results p span.result_path {
   display: block;
   margin-top: 2px;
@@ -548,6 +559,7 @@ table tr.header {
   padding-bottom: 4px;
 }
 
+#menu_search_results p.search_more,
 #search_results p.search_more {
   margin: 0;
   padding: 6px 4px;