Clarify how to supply format on the command line in the documentation

The documentation specifies that the only option that one can provide without using a dedicated coverlet.runsettings file is the Format option. Unfortunately the documentation fails to detail exactly how to use this option on the command line.

Can this be amended to the section above the options table, please?

[fhnaseer]

I digged around a bit and found out that this is the default behavior of vstest datacollector base class we derive from. This can be seen here https://github.com/microsoft/vstest/blob/main/src/vstest.console/Processors/CollectArgumentProcessor.cs#L247-L250. So even though this isn’t officially documented by the vstest guys (doc), it is working. So you basically can pass parameters like:

dotnet test --collect:"XPlat Code Coverage;Format=json;Hello=world"

This change adds/updates elements inside collector element in the runsettings file. It was added to specify output format without using a runsettings or overriding runsettings file for MS code coverage scenario.

dotnet test --collect:"Code Coverage;Format=Cobertura"

<DataCollectors>
  <DataCollector friendlyName="Code Coverage" uri="datacollector://Microsoft/CodeCoverage/2.0">
    <Configuration>
      <Format>Cobertura</Format>      <=================== This line is added into the runsettings file.

However, the implementation is generic and can be used by others as well. So, coverlet can also use similar command to specify format.

[silkfire]

The wording is much clearer now and in-tune with the official documentation. I really appreciate it, thank you.