Skip to content

Grammatical issue in README: lack of parallelism #10761

@dellch

Description

@dellch

Overview

The first sentence in the README under the "VSTest" heading lacks parallelism, which impacts clarity and grammatical correctness.

Current sentence

The Visual Studio Test Platform is an open and extensible test platform that enables running tests, collect diagnostics data and report results.

(emphasis added)

Problem

The list of actions (verbs)—"running," "collect," and "report"—does not follow a consistent structure.

Proposal

The Visual Studio Test Platform is an open and extensible test platform that runs tests, collects diagnostics data, and reports results.

Following recommendations from Microsoft's Style Guide, this:

Note: This proposal also includes the Oxford comma, which is consistent with the next sentence in the README, usage in SECURITY.md, and Microsoft's Style Guide (see also their top 10 tips for style and voice).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions