Improve comments for the QueryChunks func

contracts.go

@@ -31,8 +31,11 @@ type ChunkParser struct {
 
 	ChunkSize int
 
-	// This attribute must be a func(chunk []<Record>) error,
+	// This attribute must be a function with the following signature:
-	// where the actual Record should be a struct
+	//
+	// `func(chunk []<Record>) error`.
+	//
+	// Where the actual Record type should be of a struct
 	// representing the rows you are expecting to receive.
 	ForEachChunk interface{}
 }

kiss_orm.go

@@ -112,18 +112,21 @@ func (c Client) QueryOne(
 }
 
 // QueryChunks is meant to perform queries that returns
-// many results and should only be used for that purpose.
+// more results than would normally fit on memory,
+// for others cases the Query and QueryOne functions are indicated.
 //
-// It ChunkParser argument will inform the query and its params,
+// The ChunkParser argument has 4 attributes:
-// and the information that will be used to iterate on the results,
+// (1) The Query;
-// namely:
+// (2) The query args;
-// (1) The Chunk, which must be a pointer to a slice of structs where
+// (3) The chunk size;
-// the results of the query will be kept on each iteration.
+// (4) A callback function called ForEachChunk, that will be called
-// (2) The ChunkSize that describes how many rows should be loaded
+// to process each chunk loaded from the database.
-// on the Chunk slice before running the iteration callback.
+//
-// (3) The ForEachChunk function, which is the iteration callback
+// Note that the signature of the ForEachChunk callback can be
-// and will be called right after the Chunk is filled with rows
+// any function that receives a slice of structs or a slice of
-// and/or after the last row is read from the database.
+// pointers to struct as its only argument and that reflection
+// will be used to instantiate this argument and to fill it
+// with the database rows.
 func (c Client) QueryChunks(
 	ctx context.Context,
 	parser ChunkParser,