devdocs/specs/core-display-format-template-system.txt

@@ -1,9 +1,12 @@
 DISPLAY FORMAT TEMPLATE SYSTEM SPECS
 
-Display format (aka name display format) templates are used to customize what is shown in minimal display areas in order for a user to identify a record uniquely
+OVERVIEW 
+
+Display format template (aka name display format) templates are used to customize what is shown in minimal display areas in order for a user to identify a record uniquely
 for selection purposes.
 
-Raven will rely much more heavily on this for several reasons so it needs to be a solid integral part of Raven
+This is used for both small form factor grids (see core-main-grids.txt) i.e. on a phone as the only column displayed
+This is also used for picklists inside forms like drop down boxes etc
 
 CASES
 
@@ -12,9 +15,10 @@ CASES
 REQUIREMENTS
 
 Client
-    - Main grid lists will be very narrow and in many (if not all) cases show only a single column
+    - Main grid lists < 600px show only a single column based on template
     - Selection drop down boxes in forms for selecting other objects
     - Template editor under global settings for all main list objects
+    
 
 Server
     - List of templates with their column selections