DAS-2180: Explain self-consistent grids.

README.md

@@ -38,7 +38,7 @@ def create_browse(
     """Create browse imagery from an input geotiff.
 
     This is the exposed library function to allow users to create browse images
-    from the hybig library. It parses the input params and constructs the
+    from the hybig-py library. It parses the input params and constructs the
     correct Harmony input structure [Message.Format] to call the service's
     entry point create_browse_imagery.
 
@@ -86,7 +86,9 @@ def create_browse(
               * height and width
               * scale_sizes (in the x and y horizontal spatial dimensions)
             * Specify all three of the above, but ensure values are consistent
-              with one another.
+              with one another, noting that:
+              scale_size.x = (scale_extent.x.max - scale_extent.x.min) / width
+              scale_size.y = (scale_extent.y.max - scale_extent.y.min) / height
 
     Returns:
         List of 3-element tuples. These are the file paths of:
@@ -110,6 +112,8 @@ def create_browse(
             "https://remote-colortable",
             logger,
         )
+
+    """
 ```
 
 ### Reprojection

hybig/browse.py

@@ -99,7 +99,9 @@ def create_browse(
               * height and width
               * scale_sizes (in the x and y horizontal spatial dimensions)
             * Specify all three of the above, but ensure values are consistent
-              with one another.
+              with one another, noting that:
+              scale_size.x = (scale_extent.x.max - scale_extent.x.min) / width
+              scale_size.y = (scale_extent.y.max - scale_extent.y.min) / height
 
     Returns:
         List of 3-element tuples. These are the file paths of: