better UI: add more informative text and related links

app/views/institutions/_institution_fields.html.erb

@@ -1,24 +1,40 @@
 <% debug = true %> <!-- Set to true to display debug information -->
 
+<div class="alert alert-info">
+  <b>Three Ways to Enter Institution Data</b>
+  <ul>
+    <li>Option 1: Search for the institution <b>title</b> and select it from the suggestion list.</li>
+    <li>Option 2: Retrieve the data by entering the institution's <b>ROR ID</b>.
+    </li>
+    <li>Option 3: If your institution does not have a ROR ID, <b>manually</b> fill in the required fields.</li>
+  </ul>
+</div>
+
+
+
+
 <div id="ror_query_name"  class="form-group">
   <div class="form-group">
-    <%= f.label :title, "Name", class: "required" %>
+    <%= f.label :title, class: "required" %>
     <%= f.text_field :title, class: "form-control typeahead", id: "institution_title" %>
     <small class="form-text text-muted">
       <em>
-      Begin typing to activate a suggestion list. Please choose an institution from the list, if available. If your institution is not listed, continue typing to enter its name manually.
+      Begin typing to activate a suggestion list. Please choose an institution from the list, if available. If your institution is not listed, continue typing to enter its title manually.
       </em>
     </small>
   </div>
 
   <div class="form-group">
     <%= f.label :ror_id, 'ROR ID' -%>
-    <button type="button" id="fetch-ror-data-with-id" class="btn btn-sm btn-primary">fetch</button>
+    <%= link_to(image('ror_id', title: 'ROR'), 'https://ror.org/', target: '_blank') %>
+    <%= help_icon('The ROR ID (Research Organization Registry Identifier) is a unique 9-character alphanumeric code (e.g., 01f7bcy98).
+   To find out more and get your ORCID ID please visit https://ror.org/') -%>
     <%= f.text_field :ror_id, :class=>"form-control" -%>
     <small class="form-text text-muted">
-      <em>The ROR ID (Research Organization Registry Identifier) is a unique 9-character alphanumeric code (e.g., 01f7bcy98).
-        Please do not include the prefix (e.g., https://ror.org/).</em>
+      <em>Enter the ID only (e.g., 01f7bcy98), then click on the fetch button.</em>
     </small>
+    <button type="button" id="fetch-ror-data-with-id" class="btn btn-sm btn-primary">fetch</button>
+
   </div>
         <div class="form-group">
           <%= f.label :city -%>

config/image_files/image_file_dictionary.yml

@@ -113,6 +113,7 @@ openbis_square: 'logos/openbis-square.png'
 openbis: 'logos/openbis.png'
 open: 'famfamfam_silk/lock_open.png'
 orcid_id: 'logos/orcid_16x16.png'
+ror_id: 'logos/ror_16x16.png'
 order: 'famfamfam_silk/arrow_up.png'
 organise: 'famfamfam_silk/folder.png'
 organism_avatar: 'misc_icons/cell3.png'