microsoft / microsoft/WSL

Improve help text with clearer message for --terminate option

Open
#10,098 1 comment 0 reactions 0 assignees View on GitHub
feature
Dominant language
C++
Stars
33.7k
Forks
1.8k
Avg merge
3d 17h
Merged PRs (30d)
116

Description

**Is your feature request related to a problem? Please describe.**
the term "terminate" can be incorrectly translated depending on languages.

**Describe the solution you'd like**
The current help text could be improved by adding context with `(shutdown)`

from:

```
--terminate, -t
Terminates the specified distribution.
```

to:

```

--terminate, -t
Terminates (shutdown) the specified distribution.
```

**Describe alternatives you've considered**
nothing

**Additional context**
`(shutdown)` might also be the wrong context since there is no shutdown process executed. Instead `--terminate` **kills** a Windows PID? or what better term or short phrase added that could be used as additional context to describe what really happens with this option ? If a user opts to NOT use systemd, then would the chosen term or short phrase have a slightly different meaning here? Somethings to consider in this help text improvement issue.

Contributor guide

Open the contributing guide

Research direction

Start by locating the WSL CLI help-text definition for --terminate and verify what the option actually does, including whether systemd changes that behavior. Done means agreeing on a short, accurate replacement for the current description and updating the corresponding help text.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp
Domain
cli, operating-systems
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.