{"thread":{"id":"59284","subject":"[PATCH] Documentation/MyFirstContribution: add setup template for git send-email","startedAt":"2023-02-22T01:14:03Z","lastAt":"2023-02-26T13:19:56Z","messageCount":15,"participants":["Vivan Garg","Victoria Dye","Benson Muite","Bagas Sanjaya"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"472421","messageId":"20230222011317.97943-1-gvivan6@gmail.com","threadId":"59284","inReplyTo":null,"subject":"[PATCH] Documentation/MyFirstContribution: add setup template for git send-email","fromName":"Vivan Garg","fromEmail":"gvivan6@gmail.com","sentAt":"2023-02-22T01:13:17Z","receivedAt":"2023-02-22T01:14:03Z","isPatch":true,"sender":{"key":"gvivan6@gmail.com","avatar":null},"body":"The doumentation under [[setup-git-send-email]] fails to describe what\nneeds to be done with the SMTP server information. Although the email\nprovider will tell you the specifics (such as the serverport), it must\nalways be added to gitconfig. By adding this, a new contributor can\nsimply find the information and insert it into the template, saving them\nthe headache of figuring out what to do with the information.\nTherefore, add a template that describes what to do with the\ninformation obtained through the email provider.\n\nSigned-off-by: Vivan Garg <gvivan6@gmail.com>\n---\nThe commit subject line is over 50 columns long, but the file path takes \nup the majority of the space, which I thought was important because it \nshows that only the documentation is being edited. \n\nThe reason I felt compelled to include this is that, while it is simple \nto find the SMTP server information required from the email provider, it \ntakes a little extra effort to figure out what to do with that information.\nHowever, because it must always be added to git config, making this change \nmakes it easier for anyone to find which fields they need and what they \nneed to do with the information. \n\n Documentation/MyFirstContribution.txt | 30 ++++++++++++++++++++++++---\n 1 file changed, 27 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex ccfd0cb5f3..37fd416b29 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -999,9 +999,33 @@ provider, and so will not be covered in this tutorial, beyond stating that in\n many distributions of Linux, `git-send-email` is not packaged alongside the\n typical `git` install. You may need to install this additional package; there\n are a number of resources online to help you do so. You will also need to\n-determine the right way to configure it to use your SMTP server; again, as this\n-configuration can change significantly based on your system and email setup, it\n-is out of scope for the context of this tutorial.\n+determine the right way to configure it to use your SMTP server; this\n+configuration can change significantly based on your system and email setup, \n+but at a minimum, you'll need to edit gitconfig and set the following \n+parameters:\n+\n+----\n+$ vim ~/.gitconfig\n+\n+[sendemail]\n+    smtpServer = smtp.gmail.com\n+    smtpServerPort = 587\n+    smtpEncryption = tls\n+    smtpUser = my_email@gmail.com\n+    # (Optional: we'll leave this commented out and use a different way)\n+    # smtpPass = PASSWORD\n+[credential]\n+    helper = store\n+----\n+\n+ . This example uses gmail as the email provider and the official data\n+   available as of 21/02/2023. You should check the latest information for \n+   the email provider you intend to use (including gmail).\n+   \n+ . The `[credential] helper = store` tells git, when a user runs a git \n+   command that requires authentication, to store the credentials in a file\n+   on the local machine so that the user does not have to enter them again \n+   in the future.\n \n [[format-patch]]\n === Preparing Initial Patchset\n-- \n2.37.0 (Apple Git-136)\n\n"},{"id":"472457","messageId":"a6b0cf3b-af44-3d35-3de1-62aaf65f1543@github.com","threadId":"59284","inReplyTo":"20230222011317.97943-1-gvivan6@gmail.com","subject":"Re: [PATCH] Documentation/MyFirstContribution: add setup template for git send-email","fromName":"Victoria Dye","fromEmail":"vdye@github.com","sentAt":"2023-02-22T21:18:41Z","receivedAt":"2023-02-22T21:18:52Z","isPatch":true,"sender":{"key":"vdye@github.com","avatar":"https://avatars.githubusercontent.com/u/3619353?v=4"},"body":"It's generally good practice to CC contributors that have been recently\nand/or heavily involved in the code you're changing. Given that, I've CC'd\nEmily Shaffer (original author of the doc, including the section you'd like\nto change).\n\nVivan Garg wrote:\n> The doumentation under [[setup-git-send-email]] fails to describe what\n\ns/doumentation/documentation\n\n> needs to be done with the SMTP server information. Although the email\n> provider will tell you the specifics (such as the serverport), it must\n> always be added to gitconfig. By adding this, a new contributor can\n> simply find the information and insert it into the template, saving them\n> the headache of figuring out what to do with the information.\n> Therefore, add a template that describes what to do with the\n> information obtained through the email provider.\n> \n> Signed-off-by: Vivan Garg <gvivan6@gmail.com>\n> ---\n> The commit subject line is over 50 columns long, but the file path takes \n> up the majority of the space, which I thought was important because it \n> shows that only the documentation is being edited.\n\nEarlier commits related to this file start with just \"MyFirstContribution:\",\nso you can leave out the \"Documentation/\" prefix to stay under the 50\ncharacter width.\n \n> \n> The reason I felt compelled to include this is that, while it is simple \n> to find the SMTP server information required from the email provider, it \n> takes a little extra effort to figure out what to do with that information.\n> However, because it must always be added to git config, making this change \n> makes it easier for anyone to find which fields they need and what they \n> need to do with the information. \n> \n>  Documentation/MyFirstContribution.txt | 30 ++++++++++++++++++++++++---\n>  1 file changed, 27 insertions(+), 3 deletions(-)\n> \n> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\n> index ccfd0cb5f3..37fd416b29 100644\n> --- a/Documentation/MyFirstContribution.txt\n> +++ b/Documentation/MyFirstContribution.txt\n> @@ -999,9 +999,33 @@ provider, and so will not be covered in this tutorial, beyond stating that in\n>  many distributions of Linux, `git-send-email` is not packaged alongside the\n>  typical `git` install. You may need to install this additional package; there\n>  are a number of resources online to help you do so. You will also need to\n> -determine the right way to configure it to use your SMTP server; again, as this\n> -configuration can change significantly based on your system and email setup, it\n> -is out of scope for the context of this tutorial.\n> +determine the right way to configure it to use your SMTP server; this\n> +configuration can change significantly based on your system and email setup, \n> +but at a minimum, you'll need to edit gitconfig and set the following \n> +parameters:\n\nThe section you're replacing explicitly states that providing example\nconfiguration is out of scope for this document. That's for good reason; the\nexample config you've provided isn't universal to all developer setups. It\nwould be more confusing to a new contributor if we recommended a config\nthat's incompatible with their setup than if we left it open-ended as it is\nnow.\n\nHowever, if you still want to make the guidance in this section more\nspecific, you could add a 'linkgit:git-config' link and note that the\nrelevant SMTP configs are under the 'sendemail' section.\n\n> +\n> +----\n> +$ vim ~/.gitconfig\n> +\n> +[sendemail]\n> +    smtpServer = smtp.gmail.com\n> +    smtpServerPort = 587\n> +    smtpEncryption = tls\n> +    smtpUser = my_email@gmail.com\n> +    # (Optional: we'll leave this commented out and use a different way)\n> +    # smtpPass = PASSWORD\n> +[credential]\n> +    helper = store\n> +----\n> +\n> + . This example uses gmail as the email provider and the official data\n> +   available as of 21/02/2023. You should check the latest information for \n> +   the email provider you intend to use (including gmail).\n> +   \n> + . The `[credential] helper = store` tells git, when a user runs a git \n> +   command that requires authentication, to store the credentials in a file\n> +   on the local machine so that the user does not have to enter them again \n> +   in the future.\n>  \n>  [[format-patch]]\n>  === Preparing Initial Patchset\n\n"},{"id":"472472","messageId":"CADupsJNVV+GqV9+On6rWiDfVE4ryCvtwzcLAN_GuDcysKXyACQ@mail.gmail.com","threadId":"59284","inReplyTo":"a6b0cf3b-af44-3d35-3de1-62aaf65f1543@github.com","subject":"Re: [PATCH] Documentation/MyFirstContribution: add setup template for git send-email","fromName":"Vivan Garg","fromEmail":"v.garg.work@gmail.com","sentAt":"2023-02-23T04:09:46Z","receivedAt":"2023-02-23T04:10:02Z","isPatch":true,"sender":{"key":"v.garg.work@gmail.com","avatar":null},"body":"> It's generally good practice to CC contributors that have been recently\n> and/or heavily involved in the code you're changing. Given that, I've CC'd\n> Emily Shaffer (original author of the doc, including the section you'd like\n> to change).\n\nI see, will do in the future.\n\n> Earlier commits related to this file start with just \"MyFirstContribution:\",\n> so you can leave out the \"Documentation/\" prefix to stay under the 50\n> character width.\n\nNoted.\n\n> The section you're replacing explicitly states that providing example\n> configuration is out of scope for this document. That's for good reason; the\n> example config you've provided isn't universal to all developer setups. It\n> would be more confusing to a new contributor if we recommended a config\n> that's incompatible with their setup than if we left it open-ended as it is\n> now.\n\nOh, I thought you had to set these parameters, i.e. smtpServer, smtpServerPort,\nsmtpEncryption, smtpUser, and smtpPass in gitConfig regardless of the setup (I\ndid some googling as well). However, I'll take your word for it that it may be\nincompatible with some setups. Thanks for pointing that out!\n\n> However, if you still want to make the guidance in this section more\n> specific, you could add a 'linkgit:git-config' link and note that the\n> relevant SMTP configs are under the 'sendemail' section.\n\nThat sounds like a good addition! I'll do it then. Thanks!\n"},{"id":"472478","messageId":"20230223054040.30088-1-gvivan6@gmail.com","threadId":"59284","inReplyTo":"20230222011317.97943-1-gvivan6@gmail.com","subject":"[PATCH v2 0/1] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"gvivan6@gmail.com","sentAt":"2023-02-23T05:40:39Z","receivedAt":"2023-02-23T05:41:06Z","isPatch":true,"sender":{"key":"gvivan6@gmail.com","avatar":null},"body":"Vivan Garg (1):\n  MyFirstContribution: add note about SMTP server config\n\n Documentation/MyFirstContribution.txt | 5 ++++-\n 1 file changed, 4 insertions(+), 1 deletion(-)\n\nRange-diff against v1:\n1:  bd9bc70307 < -:  ---------- Documentation/MyFirstContribution: add setup template for git send-email\n-:  ---------- > 1:  d295b4d913 MyFirstContribution: add note about SMTP server config\n-- \n2.37.0 (Apple Git-136)\n\n"},{"id":"472479","messageId":"20230223054040.30088-2-gvivan6@gmail.com","threadId":"59284","inReplyTo":"20230223054040.30088-1-gvivan6@gmail.com","subject":"[PATCH v2 1/1] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"gvivan6@gmail.com","sentAt":"2023-02-23T05:40:40Z","receivedAt":"2023-02-23T05:41:21Z","isPatch":true,"sender":{"key":"gvivan6@gmail.com","avatar":null},"body":"In the documentation on using git-send-email, it was noted that the configuration\nfor sending email can vary based on your operating system and email provider.\nHowever, it was not explicitly stated that you will need to set up your SMTP\nserver details in git's configuration file under the 'sendemail' section. This\ninformation is critical for users who are new to using git-send-email and may\nnot be familiar with the additional setup required to use their SMTP server. By\nadding this note to the documentation, the aim is to provide users with a more\ncomplete understanding of the configuration process and help them avoid\npotential roadblocks in setting up git-send-email.\n\nSigned-off-by: Vivan Garg <gvivan6@gmail.com>\n---\n Documentation/MyFirstContribution.txt | 5 ++++-\n 1 file changed, 4 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex ccfd0cb5f3..ca095283d3 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -1001,7 +1001,10 @@ typical `git` install. You may need to install this additional package; there\n are a number of resources online to help you do so. You will also need to\n determine the right way to configure it to use your SMTP server; again, as this\n configuration can change significantly based on your system and email setup, it\n-is out of scope for the context of this tutorial.\n+is out of scope for the context of this tutorial. Additionally, note that you \n+will need to set up your SMTP server details in git's configuration file. The \n+relevant settings can be found under the 'sendemail' section (see \n+linkgit:git-config[1]).\n \n [[format-patch]]\n === Preparing Initial Patchset\n-- \n2.37.0 (Apple Git-136)\n\n"},{"id":"472481","messageId":"cb69979d-a0f1-d4dc-6e94-2d1652ec69ea@github.com","threadId":"59284","inReplyTo":"20230223054040.30088-2-gvivan6@gmail.com","subject":"Re: [PATCH v2 1/1] MyFirstContribution: add note about SMTP server config","fromName":"Victoria Dye","fromEmail":"vdye@github.com","sentAt":"2023-02-23T06:23:49Z","receivedAt":"2023-02-23T06:23:55Z","isPatch":true,"sender":{"key":"vdye@github.com","avatar":"https://avatars.githubusercontent.com/u/3619353?v=4"},"body":"Vivan Garg wrote:\n> In the documentation on using git-send-email, it was noted that the configuration\n> for sending email can vary based on your operating system and email provider.\n> However, it was not explicitly stated that you will need to set up your SMTP\n> server details in git's configuration file under the 'sendemail' section. \n\nThis is a bit of an overstatement of the issue. The existing documentation\n*does* say that you need to configure Git for your SMTP server:\n\n> You will also need to determine the right way to configure it to use your\n> SMTP server; again, as this configuration can change significantly based\n> on your system and email setup, it is out of scope for the context of this\n> tutorial.\n\nThe only thing it could use is a bit more specificity around which options\nneed configuring. With that in mind...\n\n> This information is critical for users who are new to using git-send-email and may\n> not be familiar with the additional setup required to use their SMTP server. By\n> adding this note to the documentation, the aim is to provide users with a more\n> complete understanding of the configuration process and help them avoid\n> potential roadblocks in setting up git-send-email.\n> \n> Signed-off-by: Vivan Garg <gvivan6@gmail.com>\n> ---\n>  Documentation/MyFirstContribution.txt | 5 ++++-\n>  1 file changed, 4 insertions(+), 1 deletion(-)\n> \n> diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\n> index ccfd0cb5f3..ca095283d3 100644\n> --- a/Documentation/MyFirstContribution.txt\n> +++ b/Documentation/MyFirstContribution.txt\n> @@ -1001,7 +1001,10 @@ typical `git` install. You may need to install this additional package; there\n>  are a number of resources online to help you do so. You will also need to\n>  determine the right way to configure it to use your SMTP server; again, as this\n>  configuration can change significantly based on your system and email setup, it\n> -is out of scope for the context of this tutorial.\n> +is out of scope for the context of this tutorial. Additionally, note that you \n> +will need to set up your SMTP server details in git's configuration file. The \n\n...this sentence seems to ignore the one that precedes it. The documentation\njust finishes telling the reader \"you'll need to configure Git for SMTP\",\nwhich you now follow with \"also, you need to configure Git for SMTP\" -\nbasically saying the same thing twice. If you drop the sentence starting\nwith \"Additionally, ...\", though, the sentence after (starting with \"The\nrelevant settings...\") flows nicely from the existing paragraph while still\nadding specificity to the SMTP configuration guidance.\n\n> +relevant settings can be found under the 'sendemail' section (see \n\nsuper-nit: \"the 'sendemail' section\" could be clearer about the fact that\nit's the a section *of the '.gitconfig'* - how about something like \"the\n'sendemail' section of the Git config file\"?\n\n> +linkgit:git-config[1]).\n>  \n>  [[format-patch]]\n>  === Preparing Initial Patchset\n\n"},{"id":"472482","messageId":"be5fbb48-4599-f6d0-e7c3-cf0470ce8bbd@github.com","threadId":"59284","inReplyTo":"20230223054040.30088-1-gvivan6@gmail.com","subject":"Re: [PATCH v2 0/1] MyFirstContribution: add note about SMTP server config","fromName":"Victoria Dye","fromEmail":"vdye@github.com","sentAt":"2023-02-23T06:24:18Z","receivedAt":"2023-02-23T06:24:23Z","isPatch":true,"sender":{"key":"vdye@github.com","avatar":"https://avatars.githubusercontent.com/u/3619353?v=4"},"body":"Vivan Garg wrote:\n> Vivan Garg (1):\n>   MyFirstContribution: add note about SMTP server config\n> \n>  Documentation/MyFirstContribution.txt | 5 ++++-\n>  1 file changed, 4 insertions(+), 1 deletion(-)\n> \n> Range-diff against v1:\n> 1:  bd9bc70307 < -:  ---------- Documentation/MyFirstContribution: add setup template for git send-email\n> -:  ---------- > 1:  d295b4d913 MyFirstContribution: add note about SMTP server config\n\nSince you also did this in your microproject, it's worth pointing out: you\ndon't need a cover letter for a single-patch submission (see \"Bonus Chapter:\nOne-Patch Changes\" in MyFirstContribution). You can include the range-diff\nbelow the '---' line (i.e., below the commit message) in your patch.\n"},{"id":"472484","messageId":"CADupsJP6T8OFCEJsyy4uFHvk8P-CfBODYpcR1n5jEWUiAND4Rw@mail.gmail.com","threadId":"59284","inReplyTo":"be5fbb48-4599-f6d0-e7c3-cf0470ce8bbd@github.com","subject":"Re: [PATCH v2 0/1] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"v.garg.work@gmail.com","sentAt":"2023-02-23T06:47:41Z","receivedAt":"2023-02-23T06:48:18Z","isPatch":true,"sender":{"key":"v.garg.work@gmail.com","avatar":null},"body":"> Since you also did this in your microproject, it's worth pointing out: you\n> don't need a cover letter for a single-patch submission (see \"Bonus Chapter:\n> One-Patch Changes\" in MyFirstContribution). You can include the range-diff\n> below the '---' line (i.e., below the commit message) in your patch.\n\nI didn't include the cover letter in either v1 but thought the range-diff was\nimportant so I kept it in both v2's. Next time, I'll just put it below\nthe commit\nmessage. Thanks!\n"},{"id":"472506","messageId":"20230223082759.36021-1-gvivan6@gmail.com","threadId":"59284","inReplyTo":"20230222011317.97943-1-gvivan6@gmail.com","subject":"[PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"gvivan6@gmail.com","sentAt":"2023-02-23T08:27:59Z","receivedAt":"2023-02-23T08:28:33Z","isPatch":true,"sender":{"key":"gvivan6@gmail.com","avatar":null},"body":"The documentation on using git-send-email previously mentioned the need\nto configure git for your operating system and email provider, but did\nnot provide specific details on the relevant configuration settings.\nThis commit adds a note specifying that the relevant settings can be\nfound under the 'sendemail' section of Git's configuration file, with a\nlink to the relevant documentation. The aim is to provide users with a\nmore complete understanding of the configuration process and help them\navoid potential roadblocks in setting up git-send-email.\n\nSigned-off-by: Vivan Garg <gvivan6@gmail.com>\n---\n Documentation/MyFirstContribution.txt | 4 +++-\n 1 file changed, 3 insertions(+), 1 deletion(-)\n \nRange-diff against v2:\n1:  d295b4d913 ! 1:  8710c50b1d MyFirstContribution: add note about SMTP server config\n    @@ Metadata\n      ## Commit message ##\n         MyFirstContribution: add note about SMTP server config\n     \n    -    In the documentation on using git-send-email, it was noted that the configuration\n    -    for sending email can vary based on your operating system and email provider.\n    -    However, it was not explicitly stated that you will need to set up your SMTP\n    -    server details in git's configuration file under the 'sendemail' section. This\n    -    information is critical for users who are new to using git-send-email and may\n    -    not be familiar with the additional setup required to use their SMTP server. By\n    -    adding this note to the documentation, the aim is to provide users with a more\n    -    complete understanding of the configuration process and help them avoid\n    -    potential roadblocks in setting up git-send-email.\n    +    The documentation on using git-send-email previously mentioned the need\n    +    to configure git for your operating system and email provider, but did\n    +    not provide specific details on the relevant configuration settings.\n    +    This commit adds a note specifying that the relevant settings can be\n    +    found under the 'sendemail' section of Git's configuration file, with a\n    +    link to the relevant documentation. The aim is to provide users with a\n    +    more complete understanding of the configuration process and help them\n    +    avoid potential roadblocks in setting up git-send-email.\n     \n         Signed-off-by: Vivan Garg <gvivan6@gmail.com>\n     \n    @@ Documentation/MyFirstContribution.txt: typical `git` install. You may need to in\n      determine the right way to configure it to use your SMTP server; again, as this\n      configuration can change significantly based on your system and email setup, it\n     -is out of scope for the context of this tutorial.\n    -+is out of scope for the context of this tutorial. Additionally, note that you \n    -+will need to set up your SMTP server details in git's configuration file. The \n    -+relevant settings can be found under the 'sendemail' section (see \n    ++is out of scope for the context of this tutorial. The relevant settings can be \n    ++found under the 'sendemail' section of Git's configuration file. (see \n     +linkgit:git-config[1]).\n\ndiff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt\nindex ccfd0cb5f3..0430434822 100644\n--- a/Documentation/MyFirstContribution.txt\n+++ b/Documentation/MyFirstContribution.txt\n@@ -1001,7 +1001,9 @@ typical `git` install. You may need to install this additional package; there\n are a number of resources online to help you do so. You will also need to\n determine the right way to configure it to use your SMTP server; again, as this\n configuration can change significantly based on your system and email setup, it\n-is out of scope for the context of this tutorial.\n+is out of scope for the context of this tutorial. The relevant settings can be \n+found under the 'sendemail' section of Git's configuration file. (see \n+linkgit:git-config[1]).\n \n [[format-patch]]\n === Preparing Initial Patchset\n-- \n2.37.0 (Apple Git-136)\n\n"},{"id":"472507","messageId":"4de72b33-fb1a-ab8d-11b8-9e89554fa8ad@emailplus.org","threadId":"59284","inReplyTo":"20230223082759.36021-1-gvivan6@gmail.com","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Benson Muite","fromEmail":"benson_muite@emailplus.org","sentAt":"2023-02-23T08:45:18Z","receivedAt":"2023-02-23T08:45:31Z","isPatch":true,"sender":{"key":"benson_muite@emailplus.org","avatar":null},"body":"On 2/23/23 11:27, Vivan Garg wrote:\n> The documentation on using git-send-email previously mentioned the need\n> to configure git for your operating system and email provider, but did\n> not provide specific details on the relevant configuration settings.\n> This commit adds a note specifying that the relevant settings can be\n> found under the 'sendemail' section of Git's configuration file, with a\n> link to the relevant documentation. The aim is to provide users with a\n> more complete understanding of the configuration process and help them\n> avoid potential roadblocks in setting up git-send-email.\nMaybe https://git-send-email.io/ is also helpful.\n\n\n\n"},{"id":"472521","messageId":"CACzddJqv=CX8LC55_RHVi46GOUuVqY7C0iMLHaFn24uNHzPf9w@mail.gmail.com","threadId":"59284","inReplyTo":"4de72b33-fb1a-ab8d-11b8-9e89554fa8ad@emailplus.org","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"gvivan6@gmail.com","sentAt":"2023-02-23T09:20:17Z","receivedAt":"2023-02-23T09:20:33Z","isPatch":true,"sender":{"key":"gvivan6@gmail.com","avatar":null},"body":"> Maybe https://git-send-email.io/ is also helpful.\nIf you look at v1 of this patch, you'll notice that I added a template with\ninstructions that are nearly identical to the generic ones in the link.\nI was told that it doesn't work for all setups. Although there are instructions\nfor a few different setups, they most likely do not cover all of them? Perhaps\nit's best to leave it up to the contributor to decide what to do. Also, I'm not\nsure how credible the configuration settings for the other setups are.\nHowever, if the other setups are correct, I also believe it may be beneficial.\nWhat are your thoughts? I suppose I'd like to hear what other people think\nas well? Thanks!\n"},{"id":"472525","messageId":"a191c829-dfd4-a180-114d-147787d88aed@emailplus.org","threadId":"59284","inReplyTo":"CACzddJqv=CX8LC55_RHVi46GOUuVqY7C0iMLHaFn24uNHzPf9w@mail.gmail.com","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Benson Muite","fromEmail":"benson_muite@emailplus.org","sentAt":"2023-02-23T10:37:02Z","receivedAt":"2023-02-23T10:37:48Z","isPatch":true,"sender":{"key":"benson_muite@emailplus.org","avatar":null},"body":"On 2/23/23 12:20, Vivan Garg wrote:\n>> Maybe https://git-send-email.io/ is also helpful.\n> If you look at v1 of this patch, you'll notice that I added a template with\n> instructions that are nearly identical to the generic ones in the link.\n> I was told that it doesn't work for all setups. Although there are instructions\n> for a few different setups, they most likely do not cover all of them? Perhaps\n> it's best to leave it up to the contributor to decide what to do. Also, I'm not\n> sure how credible the configuration settings for the other setups are.\n> However, if the other setups are correct, I also believe it may be beneficial.\n> What are your thoughts? I suppose I'd like to hear what other people think\n> as well? Thanks!\nHave not tested all of the setups in https://git-send-email.io/ The\nFedora instructions seem fine.  It can be updated through Git, so\ncontributions for other setups are possible. There is a nice way to test:\nhttps://git-send-email.io/#step-3\n"},{"id":"472737","messageId":"CADupsJPw1GrTJDdyckUkmBfNLs4TTuGFGfV-uUOZJDOvgPCryw@mail.gmail.com","threadId":"59284","inReplyTo":"a191c829-dfd4-a180-114d-147787d88aed@emailplus.org","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Vivan Garg","fromEmail":"v.garg.work@gmail.com","sentAt":"2023-02-26T00:49:29Z","receivedAt":"2023-02-26T00:49:46Z","isPatch":true,"sender":{"key":"v.garg.work@gmail.com","avatar":null},"body":"> Have not tested all of the setups in https://git-send-email.io/ The\n> Fedora instructions seem fine.  It can be updated through Git, so\n> contributions for other setups are possible. There is a nice way to test:\n> https://git-send-email.io/#step-3\n\nI am waiting for someone else to offer their input on the matter. However,\nI appreciate your suggestion nonetheless.\n"},{"id":"472753","messageId":"71eaa98e-3c24-9b4e-9526-550cd7d5a420@gmail.com","threadId":"59284","inReplyTo":"20230223082759.36021-1-gvivan6@gmail.com","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Bagas Sanjaya","fromEmail":"bagasdotme@gmail.com","sentAt":"2023-02-26T13:07:58Z","receivedAt":"2023-02-26T13:08:40Z","isPatch":true,"sender":{"key":"bagasdotme@gmail.com","avatar":"https://avatars.githubusercontent.com/u/40219486?v=4"},"body":"On 2/23/23 15:27, Vivan Garg wrote:\n> @@ -1001,7 +1001,9 @@ typical `git` install. You may need to install this additional package; there\n>  are a number of resources online to help you do so. You will also need to\n>  determine the right way to configure it to use your SMTP server; again, as this\n>  configuration can change significantly based on your system and email setup, it\n> -is out of scope for the context of this tutorial.\n> +is out of scope for the context of this tutorial. The relevant settings can be \n> +found under the 'sendemail' section of Git's configuration file. (see \n> +linkgit:git-config[1]).\n>  \n\nPersonally said, besides above, I'd like to also add \"Instructions\non how to set up sending email with git send-email can be found at\nhttps://git-send-email.io\".\n\nThanks.\n\n-- \nAn old man doll... just what I always wanted! - Clara\n\n"},{"id":"472754","messageId":"57877738-5020-f2e6-a0c6-f7ee6ce7c2aa@gmail.com","threadId":"59284","inReplyTo":"a191c829-dfd4-a180-114d-147787d88aed@emailplus.org","subject":"Re: [PATCH v3] MyFirstContribution: add note about SMTP server config","fromName":"Bagas Sanjaya","fromEmail":"bagasdotme@gmail.com","sentAt":"2023-02-26T13:19:45Z","receivedAt":"2023-02-26T13:19:56Z","isPatch":true,"sender":{"key":"bagasdotme@gmail.com","avatar":"https://avatars.githubusercontent.com/u/40219486?v=4"},"body":"On 2/23/23 17:37, Benson Muite wrote:\n> Have not tested all of the setups in https://git-send-email.io/ The\n> Fedora instructions seem fine.  It can be updated through Git, so\n> contributions for other setups are possible. There is a nice way to test:\n> https://git-send-email.io/#step-3\n\nFor me, my setup is to use Postfix as \"null-client\" MTA, where all\noutgoing mails are relayed to Gmail. This way, configuring SMTP\ncredentials is delegated to the MTA and applications can be set up\nto simply specifying `/usr/sbin/sendmail` as mailer.\n\nHowever, in order for system-generated mails to be sent to my\nreal address, I have to canonicalize local `root` and `postmaster`\nrecipients via `recipient_canonical_maps` setting.\n\nThanks.\n\n-- \nAn old man doll... just what I always wanted! - Clara\n\n"}]}