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

devdocs/specs/core-main-grids.txt

@@ -1,18 +1,26 @@
 MAIN GRID SPECS
 
 OVERVIEW
+Main grids show all the stuff people have entered in Raven and are used for selection to edit/ view, filter and sort for reporting and mass operations.
+Proposed system is a hybrid grid system that has two modes to take into account the width of the display device:
+    - Xtra Small (XS ) < 600 pixels wide (my phone is 393px)
+        - In this mode only one column shows and it's formatted according to the Display Format Template
+        - DisplayFormatTemplate is specd in the core-display-format-template-system.txt doc
+        - So the user chooses which columns to show in a small factor themselves, default is name only or equivalent
 
 
 CASES
-
+None that are intrinsically grid related really, just 3 or so regarding specfic fields to add to grids
 
 
 REQUIREMENTS
 
 Client
+    - Client needs to tell the server which form of list is required, i.e. it's client window size when fetching a list
    
 
 Server
+    - Server needs to accept a parameter from the client when a grid list is fetched that tells it if it needs to send a single column templated list 
    
 
 Back AND front end