]> git.ipfire.org Git - thirdparty/git.git/commit
docs: make the purpose of using app password for Gmail more clear in send-email
authorAditya Garg <gargaditya08@live.com>
Fri, 30 May 2025 15:50:07 +0000 (15:50 +0000)
committerJunio C Hamano <gitster@pobox.com>
Fri, 30 May 2025 17:23:38 +0000 (10:23 -0700)
commit9e68aaba45156a255c35647184394bb4a05de655
tree9cbfa94e38b97c8885dbbea6f1bda15597b4330b
parent6cae42c1894c8be96f2dfb11095ff1ab5fd0b015
docs: make the purpose of using app password for Gmail more clear in send-email

The current example for Gmail suggests using app passwords for
send-email if user has multi-factor authentication set up for their
account. However, it does not clarify that the user cannot use their
normal password in case they do not have multi-factor authentication
enabled. Most likely the example was written in the days when Google
allowed using normal passwords without multi-factor authentication.

Clarify that regular passwords do not work for Gmail and app-passwords
are the only way for basic authentication. Also encourage users to use
OAuth2.0 as a more secure alternative.

While at it, also prefer using the word "mechanism" over "method" for
`OAUTHBEARER` and `XOAUTH2` since that is what official docs use.

Signed-off-by: Aditya Garg <gargaditya08@live.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-send-email.adoc