# The description of push.default=simple is misleading

1 messages from 2025-09-27 to 2025-09-27. Participants: 雨 欣.
Thread: https://gitlist.dev/t/64217

## 雨 欣, 2025-09-27 11:24

Subject: The description of push.default=simple is misleading
Message-ID: <SJ0PR20MB515802EF2B4A04688D01D2FFE419A@SJ0PR20MB5158.namprd20.prod.outlook.com>
URL: https://gitlist.dev/e/SJ0PR20MB515802EF2B4A04688D01D2FFE419A%40SJ0PR20MB5158.namprd20.prod.outlook.com

```
The description of the simple value for push.default differs between https://git-scm.com/docs/git-config and https://git-scm.com/docs/git-push, and the former is misleading:
 
simple - push the current branch with the same name on the remote.
If you are working on a centralized workflow (pushing to the same repository you pull from, which is typically origin), then you need to configure an upstream branch with the same name.
This mode is the default since Git 2.0, and is the safest option suited for beginners.
 
Comparing with the description in https://git-scm.com/docs/git-push:
 
When neither the command-line nor the configuration specifies what to push, the default behavior is used, which corresponds to the simple value for push.default: the current branch is pushed to the corresponding upstream branch, but as a safety measure, the push is aborted if the upstream branch does not have the same name as the local one.
 
In the former, the word "if" makes it sound as though an upstream branch is only required in some cases, but in reality it is always required.
```