search

dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.25k stars 5.89k forks source link

Usage of word "driver" in the documentation for dotnet.exe is confusing #36957

Open IanKemp opened 1 year ago

IanKemp commented 1 year ago

Issue description

https://learn.microsoft.com/dotnet/core/tools/dotnet, https://learn.microsoft.com/dotnet/core/tools/#driver and possibly other pages use the word "driver" to apparently mean "the thing that runs all .NET commands". But historically, the usage of "driver" within the Microsoft ecosystem has a very different connotation, specifically device drivers. The repurposing of the word "driver" here thus has potential to confuse users, especially those who are not necessarily native English speakers.

I suggest reconsidering this terminology due to its potential to confuse.

IEvangelist commented 1 year ago

I see where you're coming from, but driver is a broad term and is applicable in other aspects of software engineering. Let's ask @BillWagner what he thinks of this one.