Adjust data/README.md.

Author: quinntaylormitchell

integration-tests/tests/data/README.md

@@ -1,25 +1,27 @@
 # Integration test data
 
-The `integration-tests/tests/data` directory contains test datasets for use throughout the
-integration test system.
+The `integration-tests/tests/data` directory contains sample datasets for use throughout the
+integration test system. Each sample dataset is loaded into the test system through the
+`SampleDataset` class.
 
 ## Directory structure
 
 When augmenting or changing the contents of `integration-tests/tests/data`, the following rules
 must be observed:
 
-1. Each dataset must be located in its own directory.
-2. Each dataset directory must be a direct child of `integration-tests/tests/data`; nested dataset
-   directories are not permitted.
+1. Each sample dataset must be located in its own directory.
+2. Each sample dataset directory must be a direct child of `integration-tests/tests/data`; nested
+   dataset directories are not permitted.
 
 ## Dataset contents
 
-When adding or changing a dataset directory within `integration-tests/tests/data`, the following
-rules must be observed:
+When adding or changing a sample dataset directory within `integration-tests/tests/data`, the
+following rules must be observed:
 
-1. Each dataset directory must contain a subdirectory that holds all log files for the dataset.
-2. Each dataset directory must contain a file called `metadata.json`, which must conform to the
-   following schema:
+1. Each sample dataset directory must contain a subdirectory that holds all log files for the
+   dataset.
+2. Each sample dataset directory must contain a file called `metadata.json`, which must conform to
+   the following schema:
 
    ```json
    {
@@ -40,7 +42,7 @@ rules must be observed:
 
    | Field | Description |
    | --- | --- |
-   | `dataset_name` | The name of the dataset directory. |
+   | `dataset_name` | The name of the sample dataset directory. |
    | `unstructured` | `True` if logs are unstructured, else `False`. |
    | `timestamp_key` | The authoritative timestamp key, or `null` if there is no such key. |
    | `begin_ts` | The earliest timestamp present in the dataset (ms). |
@@ -49,26 +51,26 @@ rules must be observed:
    | `file_names` | A list of the files within `logs_subdir`. |
    | `single_match_wildcard_query` | A wildcard query that matches exactly one log message in the dataset. |
 
-## Accessing datasets within the testing system
+## Accessing sample datasets within the testing system
 
-To access a dataset from within the test system, the following rules should be observed:
+To access a sample dataset from within the test system, the following rules should be observed:
 
-1. All datasets should have their own session-scoped fixture in
-   `integration-tests/tests/fixtures/datasets.py`. Test code should access this fixture to
-   access the dataset.
-2. Each session-scoped dataset fixture should be given the same name as the dataset directory name,
+1. All sample datasets should have their own session-scoped fixture in
+   `integration-tests/tests/fixtures/sample_datasets.py`. Test code should access this fixture to
+   access the sample dataset.
+2. Each session-scoped fixture should be given the same name as the sample dataset directory name,
    and should conform to the following format:
 
    ```python
    @pytest.fixture(scope="session")
    def dataset_name(
        integration_test_path_config: IntegrationTestPathConfig,
    ) -> SampleDataset:
-       """Returns an object corresponding to the `dataset_name` test dataset."""
+       """Returns an object corresponding to the `dataset_name` sample dataset."""
        return SampleDataset(
            dataset_root_dir=integration_test_path_config.test_data_dir / "dataset_name",
        )
    ```
 
-Tests should use dataset fixtures instead of reading the logs directly, because many verification
-flows rely on dataset metadata.
+Tests should use sample dataset fixtures instead of reading the logs directly, because many
+verification flows rely on dataset metadata.