Apply suggestions from code review

Co-authored-by: Marcin Rataj <[email protected]>

tests/t0118_gateway_car_test.go

@@ -187,9 +187,8 @@ func TestGatewayCarDagScopeEntity(t *testing.T) {
 		{
 			Name: "GET CAR with dag-scope=entity of a UnixFS directory",
 			Hint: `
-				dag-scope=entity should return a CAR file with all the blocks needed to 'cat'
-				a UnixFS file at the end of the specified path, or to 'ls' a UnixFS directory
-				at the end of the specified path.
+				dag-scope=entity for a directory should return a CAR file with all of the path blocks, as well
+				as all of the blocks for directory enumeration, but not any of blocks for items below the directory.
 			`,
 			Request: Request().
 				Path("/ipfs/{{cid}}", subdirTwoSingleBlockFilesFixture.MustGetCidWithCodec(0x70)).
@@ -288,7 +287,7 @@ func TestGatewayCarDagScopeEntity(t *testing.T) {
 			Name: "GET CAR with dag-scope=entity of DAG-CBOR with Links",
 			Hint: `
 				dag-scope=entity of a DAG-CBOR (or DAG-JSON) document with IPLD Links must return
-				all necessary blocks to verify the path, but not the content of the IPLD Links.
+				all necessary blocks to verify the path, the document itself, but not the content of the IPLD Links.
 			`,
 			Request: Request().
 				Path("/ipfs/{{cid}}/document", dirWithDagCborWithLinksFixture.MustGetCidWithCodec(0x70)).
@@ -320,8 +319,8 @@ func TestGatewayCarDagScopeAll(t *testing.T) {
 		{
 			Name: "GET CAR with dag-scope=all of UnixFS directory with multiple files",
 			Hint: `
-				dag-scope=all should return a CAR file with the entire contiguous DAG
-				that begins at the end of the path query, after blocks required to verify path segments.
+				dag-scope=all should return a blocks required to verify path, and then 
+				all blocks for the entire UnixFS directory DAG (all children, recursively).
 			`,
 			Request: Request().
 				Path("/ipfs/{{cid}}/subdir", subdirWithMixedBlockFiles.MustGetCidWithCodec(0x70)).
@@ -411,7 +410,7 @@ func TestGatewayCarEntityBytes(t *testing.T) {
 		{
 			Name: "GET CAR with entity-bytes of a UnixFS directory",
 			Hint: `
-				dag-scope=entity&entity-bytes=X:Y should return a CAR file with all the blocks needed to 'ls'
+				dag-scope=entity&entity-bytes=from:to should return a CAR file with all the blocks needed to enumerate contents of
 				a UnixFS directory at the end of the specified path if the terminal element is a directory
 				(i.e. entity-bytes is effectively optional if the entity is not a file)
 			`,