# [Outreachy] internship contribution 17 messages from 2022-10-09 to 2022-10-13. Participants: NSENGIYUMVA WILBERFORCE, Christian Couder, Derrick Stolee, Luna Jernberg, Junio C Hamano, Đoàn Trần Công Danh. Thread: https://gitlist.dev/t/58587 ## NSENGIYUMVA WILBERFORCE, 2022-10-09 04:37 Subject: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiEvfkqZYq6uESMt3QYnfMDZDmPbGiQ5Qkeb77rtLV5Aug%40mail.gmail.com ``` Hi, I am Nsengiyumva Wilberforce From Uganda. I am happy that my first application for outreachy internship was accepted. When I read about Git in the project list, I got interested and I will be glad to be hooked into this community and get my hands dirty in contributions. I am eager to learn new things from my mentor and the entire community. I will be glad to hear from the community on some tips on how to get started with contribution. And more so would like to get in touch with the my mentor Best Regards, Wilberforce ``` ## Christian Couder, 2022-10-10 08:19 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CAP8UFD1o5qxSvbV05DK_J%3DzbU%3DD_%2BHS0Q2ufEFSQVaBoWw_7Ow%40mail.gmail.com In-Reply-To: ``` Hi Wilberforce, On Sun, Oct 9, 2022 at 6:46 AM NSENGIYUMVA WILBERFORCE wrote: > > Hi, I am Nsengiyumva Wilberforce From Uganda. I am happy that my first > application for outreachy internship was accepted. > > When I read about Git in the project list, I got interested and I will > be glad to be hooked into this community and get my hands dirty in > contributions. I am eager to learn new things from my mentor and the > entire community. > > I will be glad to hear from the community on some tips on how to get > started with contribution. > > And more so would like to get in touch with the my mentor As you also sent me a private message, I already replied privately. But for the public record and maybe other applicants for an Outreachy internship who might be interested in working on Git, we have information about how to get started contributing on the following pages: - https://git.github.io/Hacking-Git/ - https://git.github.io/General-Microproject-Information/ About microproject ideas, we haven't set up a specific page yet for this Outreachy round. Maybe we will do it but you shouldn't count on it. You can still take a look at the pages for the previous GSoC or Outreachy rounds like: - https://git.github.io/SoC-2022-Microprojects/ - https://git.github.io/Outreachy-23-Microprojects/ - https://git.github.io/SoC-2020-Microprojects/ You will see that some ideas are quite generic and we propose them over and over as they are still valid. You are welcome to ask specific questions (publicly is preferred so that others can benefit). Thanks again for your interest in working on Git, Christian. ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-10 12:18 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiF5KK6p7rv57YL_wsDO%2BWPifoRp1oe0F-6mo5NxLAwDWw%40mail.gmail.com In-Reply-To: ``` I see most of the articles are UNIX based, does it mean that I should have a UNIX based operating system in order to contribute? Currently, I have windows installed 11 on my PC On Mon, Oct 10, 2022 at 11:19 AM Christian Couder wrote: > > Hi Wilberforce, > > On Sun, Oct 9, 2022 at 6:46 AM NSENGIYUMVA WILBERFORCE > wrote: > > > > Hi, I am Nsengiyumva Wilberforce From Uganda. I am happy that my first > > application for outreachy internship was accepted. > > > > When I read about Git in the project list, I got interested and I will > > be glad to be hooked into this community and get my hands dirty in > > contributions. I am eager to learn new things from my mentor and the > > entire community. > > > > I will be glad to hear from the community on some tips on how to get > > started with contribution. > > > > And more so would like to get in touch with the my mentor > > As you also sent me a private message, I already replied privately. > But for the public record and maybe other applicants for an Outreachy > internship who might be interested in working on Git, we have > information about how to get started contributing on the following > pages: > > - https://git.github.io/Hacking-Git/ > - https://git.github.io/General-Microproject-Information/ > > About microproject ideas, we haven't set up a specific page yet for > this Outreachy round. Maybe we will do it but you shouldn't count on > it. You can still take a look at the pages for the previous GSoC or > Outreachy rounds like: > > - https://git.github.io/SoC-2022-Microprojects/ > - https://git.github.io/Outreachy-23-Microprojects/ > - https://git.github.io/SoC-2020-Microprojects/ > > You will see that some ideas are quite generic and we propose them > over and over as they are still valid. > > You are welcome to ask specific questions (publicly is preferred so > that others can benefit). > > Thanks again for your interest in working on Git, > Christian. ``` ## Christian Couder, 2022-10-10 16:22 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CAP8UFD26PY-53vZNZJzCRNiqaVB4fd%3DAvBtVuvMQP9p8Oqj82Q%40mail.gmail.com In-Reply-To: ``` On Mon, Oct 10, 2022 at 2:19 PM NSENGIYUMVA WILBERFORCE wrote: > > I see most of the articles are UNIX based, does it mean that I should > have a UNIX based operating system in order to contribute? > Currently, I have windows installed 11 on my PC You can install a Linux virtual machine on your PC and develop in this virtual machine, or you can install the Git for Windows SDK from: https://gitforwindows.org/#contribute It might be best to install both development environments. I will not be able to help you much with development environment issues if you develop on Windows, but if it works for you, that could be Ok, especially if you use GitGitGadget too. ``` ## Derrick Stolee, 2022-10-10 16:33 Subject: Re: [Outreachy] internship contribution Message-ID: <9fcfc8b0-772d-08c3-595b-5a5a139d7ecd@github.com> URL: https://gitlist.dev/e/9fcfc8b0-772d-08c3-595b-5a5a139d7ecd%40github.com In-Reply-To: ``` On 10/10/2022 12:22 PM, Christian Couder wrote: > On Mon, Oct 10, 2022 at 2:19 PM NSENGIYUMVA WILBERFORCE > wrote: >> >> I see most of the articles are UNIX based, does it mean that I should >> have a UNIX based operating system in order to contribute? >> Currently, I have windows installed 11 on my PC > > You can install a Linux virtual machine on your PC and develop in this > virtual machine, or you can install the Git for Windows SDK from: > > https://gitforwindows.org/#contribute > > It might be best to install both development environments. I will not > be able to help you much with development environment issues if you > develop on Windows, but if it works for you, that could be Ok, > especially if you use GitGitGadget too. The git-for-windows/git fork has some information that is helpful for developing Git on a Windows machine [1]. This also includes details about recommending a Linux VM with Windows' Hyper-V system because compiling and testing Git is so much faster on Linux. [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md Good luck! -Stolee ``` ## Luna Jernberg, 2022-10-10 16:57 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CADo9pHgcfwV53ooyM8Dh5jVO2rxO-tUHeLovd7HYLdTSOkNtyA%40mail.gmail.com In-Reply-To: <9fcfc8b0-772d-08c3-595b-5a5a139d7ecd@github.com> ``` Maybe WSL can be used?: https://learn.microsoft.com/en-us/windows/wsl/install On Mon, Oct 10, 2022 at 6:55 PM Derrick Stolee wrote: > > On 10/10/2022 12:22 PM, Christian Couder wrote: > > On Mon, Oct 10, 2022 at 2:19 PM NSENGIYUMVA WILBERFORCE > > wrote: > >> > >> I see most of the articles are UNIX based, does it mean that I should > >> have a UNIX based operating system in order to contribute? > >> Currently, I have windows installed 11 on my PC > > > > You can install a Linux virtual machine on your PC and develop in this > > virtual machine, or you can install the Git for Windows SDK from: > > > > https://gitforwindows.org/#contribute > > > > It might be best to install both development environments. I will not > > be able to help you much with development environment issues if you > > develop on Windows, but if it works for you, that could be Ok, > > especially if you use GitGitGadget too. > > The git-for-windows/git fork has some information that is helpful > for developing Git on a Windows machine [1]. This also includes > details about recommending a Linux VM with Windows' Hyper-V system > because compiling and testing Git is so much faster on Linux. > > [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md > > Good luck! > -Stolee ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-10 18:17 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiH8EPWpTuOJg1hSthFP1xBxurjN7J0J00g6xvFi_vbcYw%40mail.gmail.com In-Reply-To: ``` thank you all for your suggestions, let me see what is easy for me On Mon, Oct 10, 2022 at 7:58 PM Luna Jernberg wrote: > > Maybe WSL can be used?: https://learn.microsoft.com/en-us/windows/wsl/install > > On Mon, Oct 10, 2022 at 6:55 PM Derrick Stolee wrote: > > > > On 10/10/2022 12:22 PM, Christian Couder wrote: > > > On Mon, Oct 10, 2022 at 2:19 PM NSENGIYUMVA WILBERFORCE > > > wrote: > > >> > > >> I see most of the articles are UNIX based, does it mean that I should > > >> have a UNIX based operating system in order to contribute? > > >> Currently, I have windows installed 11 on my PC > > > > > > You can install a Linux virtual machine on your PC and develop in this > > > virtual machine, or you can install the Git for Windows SDK from: > > > > > > https://gitforwindows.org/#contribute > > > > > > It might be best to install both development environments. I will not > > > be able to help you much with development environment issues if you > > > develop on Windows, but if it works for you, that could be Ok, > > > especially if you use GitGitGadget too. > > > > The git-for-windows/git fork has some information that is helpful > > for developing Git on a Windows machine [1]. This also includes > > details about recommending a Linux VM with Windows' Hyper-V system > > because compiling and testing Git is so much faster on Linux. > > > > [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md > > > > Good luck! > > -Stolee ``` ## Derrick Stolee, 2022-10-10 18:22 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/ae8a98d9-eec1-cdcd-67a3-695aaca7f5ae%40github.com In-Reply-To: ``` On 10/10/2022 2:17 PM, NSENGIYUMVA WILBERFORCE wrote: > thank you all for your suggestions, let me see what is easy for me > > On Mon, Oct 10, 2022 at 7:58 PM Luna Jernberg wrote: >> >> Maybe WSL can be used?: https://learn.microsoft.com/en-us/windows/wsl/install If you do go the WSL route, then please share your learnings by updating the contributing doc either in git-for-windows/git [1] or here on the mailing list. [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md Thanks, -Stolee ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-11 06:48 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiFC0mjvY494AVZMB952Ux-TPyA-Uetu1xQ6FiHA_vaRaA%40mail.gmail.com In-Reply-To: ``` Simple steps that I followed on windows 10 -open the command line application with administrator rights -run wsl --install. - Restart the computer -check installed distributions, wsl --list --online -run ubuntu distribution, wsl -d ubuntu -add username and password After the above steps I was able to set up git on ubuntu NB: to start wsl when you stopped, just type wsl -u "the username u created" in the command line On Mon, Oct 10, 2022 at 9:22 PM Derrick Stolee wrote: > > On 10/10/2022 2:17 PM, NSENGIYUMVA WILBERFORCE wrote: > > thank you all for your suggestions, let me see what is easy for me > > > > On Mon, Oct 10, 2022 at 7:58 PM Luna Jernberg wrote: > >> > >> Maybe WSL can be used?: https://learn.microsoft.com/en-us/windows/wsl/install > > If you do go the WSL route, then please share your learnings by updating the > contributing doc either in git-for-windows/git [1] or here on the mailing list. > > [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md > > Thanks, > -Stolee ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-12 03:31 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiEms%3Df7%3DrXkvfmaazNkxKS1-VA-XJZOrhieQEut8f7QWA%40mail.gmail.com In-Reply-To: ``` Hi team, I am reading through "My first contribution" when I run make all doc, I get the following; SUBDIR git-gui SUBDIR gitk-git SUBDIR templates make -C Documentation all make[1]: Entering directory '/mnt/c/Users/USER/documents/git/Documentation' make[2]: Entering directory '/mnt/c/Users/USER/documents/git' make[2]: 'GIT-VERSION-FILE' is up to date. make[2]: Leaving directory '/mnt/c/Users/USER/documents/git' XMLTO git-version.1 /bin/sh: 1: xmlto: not found make[1]: *** [Makefile:355: git-version.1] Error 127 make[1]: Leaving directory '/mnt/c/Users/USER/documents/git/Documentation' make: *** [Makefile:2720: doc] Error 2 How should I go about it? On Tue, Oct 11, 2022 at 9:48 AM NSENGIYUMVA WILBERFORCE wrote: > > Simple steps that I followed on windows 10 > -open the command line application with administrator rights > -run wsl --install. > - Restart the computer > -check installed distributions, wsl --list --online > -run ubuntu distribution, wsl -d ubuntu > -add username and password > After the above steps I was able to set up git on ubuntu > NB: to start wsl when you stopped, just type wsl -u "the username u > created" in the command line > > On Mon, Oct 10, 2022 at 9:22 PM Derrick Stolee wrote: > > > > On 10/10/2022 2:17 PM, NSENGIYUMVA WILBERFORCE wrote: > > > thank you all for your suggestions, let me see what is easy for me > > > > > > On Mon, Oct 10, 2022 at 7:58 PM Luna Jernberg wrote: > > >> > > >> Maybe WSL can be used?: https://learn.microsoft.com/en-us/windows/wsl/install > > > > If you do go the WSL route, then please share your learnings by updating the > > contributing doc either in git-for-windows/git [1] or here on the mailing list. > > > > [1] https://github.com/git-for-windows/git/blob/main/CONTRIBUTING.md > > > > Thanks, > > -Stolee ``` ## Junio C Hamano, 2022-10-12 04:42 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/xmqqleplmz3n.fsf%40gitster.g In-Reply-To: ``` NSENGIYUMVA WILBERFORCE writes: > Hi team, I am reading through "My first contribution" > when I run make all doc, I get the following; > > SUBDIR git-gui > SUBDIR gitk-git > SUBDIR templates > make -C Documentation all > make[1]: Entering directory '/mnt/c/Users/USER/documents/git/Documentation' > make[2]: Entering directory '/mnt/c/Users/USER/documents/git' > make[2]: 'GIT-VERSION-FILE' is up to date. > make[2]: Leaving directory '/mnt/c/Users/USER/documents/git' > XMLTO git-version.1 > /bin/sh: 1: xmlto: not found > make[1]: *** [Makefile:355: git-version.1] Error 127 > make[1]: Leaving directory '/mnt/c/Users/USER/documents/git/Documentation' > make: *** [Makefile:2720: doc] Error 2 > > How should I go about it? Googling "xmlto: not found", the first result is https://command-not-found.com/xmlto The page lists how to get and install it for various platforms, and WSL/Windows should be included there. I believe "My first contribution" recommends to first read the top-level INSTALL before continuing (and if not, it should be updated to). Simpler things first---building and installing the vanilla source code without any of your changes should be simpler and you should become confident in doing that, before you start modifying anything. Otherwise, when you encounter a problem, you would not be able to tell if you broke it with your change, or your basic set-up is not complete (e.g. missing necessary tools like xmlto) and unable to build and install from even vanilla set of sources. Have fun. ``` ## Đoàn Trần Công Danh, 2022-10-12 06:45 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/Y0Zig4XUePPhMaA3%40danh.dev In-Reply-To: ``` On 2022-10-11 21:42:52-0700, Junio C Hamano wrote: > NSENGIYUMVA WILBERFORCE writes: > > > Hi team, I am reading through "My first contribution" > > when I run make all doc, I get the following; > > > > SUBDIR git-gui > > SUBDIR gitk-git > > SUBDIR templates > > make -C Documentation all > > make[1]: Entering directory '/mnt/c/Users/USER/documents/git/Documentation' > > make[2]: Entering directory '/mnt/c/Users/USER/documents/git' > > make[2]: 'GIT-VERSION-FILE' is up to date. > > make[2]: Leaving directory '/mnt/c/Users/USER/documents/git' > > XMLTO git-version.1 > > /bin/sh: 1: xmlto: not found > > make[1]: *** [Makefile:355: git-version.1] Error 127 > > make[1]: Leaving directory '/mnt/c/Users/USER/documents/git/Documentation' > > make: *** [Makefile:2720: doc] Error 2 > > > > How should I go about it? > > Googling "xmlto: not found", the first result is > > https://command-not-found.com/xmlto > > The page lists how to get and install it for various platforms, and > WSL/Windows should be included there. > > I believe "My first contribution" recommends to first read the > top-level INSTALL before continuing (and if not, it should be > updated to). Simpler things first---building and installing the > vanilla source code without any of your changes should be simpler > and you should become confident in doing that, before you start > modifying anything. Otherwise, when you encounter a problem, you > would not be able to tell if you broke it with your change, or your > basic set-up is not complete (e.g. missing necessary tools like > xmlto) and unable to build and install from even vanilla set of > sources. Maybe he is on Windows and using Git-for-Windows SDK? I'm not sure what's included there, but I can imagine that man-pages is useless on Windows, they would prefer html docs instead. Perhaps, they want: make all && make -C Documentation html When building only html, xmlto is not necessary to be installed. -- Danh ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-12 10:37 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiGPo1j-2MxTvmV2jDYNVFV1q8%2B7TVX1uoEUpWc0o%2BRkdw%40mail.gmail.com In-Reply-To: ``` I am using ubuntu(wsl) On Wed, Oct 12, 2022 at 9:45 AM Đoàn Trần Công Danh wrote: > > On 2022-10-11 21:42:52-0700, Junio C Hamano wrote: > > NSENGIYUMVA WILBERFORCE writes: > > > > > Hi team, I am reading through "My first contribution" > > > when I run make all doc, I get the following; > > > > > > SUBDIR git-gui > > > SUBDIR gitk-git > > > SUBDIR templates > > > make -C Documentation all > > > make[1]: Entering directory '/mnt/c/Users/USER/documents/git/Documentation' > > > make[2]: Entering directory '/mnt/c/Users/USER/documents/git' > > > make[2]: 'GIT-VERSION-FILE' is up to date. > > > make[2]: Leaving directory '/mnt/c/Users/USER/documents/git' > > > XMLTO git-version.1 > > > /bin/sh: 1: xmlto: not found > > > make[1]: *** [Makefile:355: git-version.1] Error 127 > > > make[1]: Leaving directory '/mnt/c/Users/USER/documents/git/Documentation' > > > make: *** [Makefile:2720: doc] Error 2 > > > > > > How should I go about it? > > > > Googling "xmlto: not found", the first result is > > > > https://command-not-found.com/xmlto > > > > The page lists how to get and install it for various platforms, and > > WSL/Windows should be included there. > > > > I believe "My first contribution" recommends to first read the > > top-level INSTALL before continuing (and if not, it should be > > updated to). Simpler things first---building and installing the > > vanilla source code without any of your changes should be simpler > > and you should become confident in doing that, before you start > > modifying anything. Otherwise, when you encounter a problem, you > > would not be able to tell if you broke it with your change, or your > > basic set-up is not complete (e.g. missing necessary tools like > > xmlto) and unable to build and install from even vanilla set of > > sources. > > Maybe he is on Windows and using Git-for-Windows SDK? I'm not sure > what's included there, but I can imagine that man-pages is useless > on Windows, they would prefer html docs instead. Perhaps, they want: > > make all && make -C Documentation html > > When building only html, xmlto is not necessary to be installed. > > -- > Danh ``` ## Christian Couder, 2022-10-12 14:21 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CAP8UFD3sa-jLFO31QZ6QG%3DUdg-H73rn6h46QpnVRGekT1o0gmg%40mail.gmail.com In-Reply-To: ``` On Wed, Oct 12, 2022 at 12:38 PM NSENGIYUMVA WILBERFORCE wrote: > > I am using ubuntu(wsl) On a regular Ubuntu `sudo apt install xmlto` should install xmlto and you should be good to go. ``` ## Đoàn Trần Công Danh, 2022-10-12 15:18 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/Y0baxKPxHp7UdYTi%40danh.dev In-Reply-To: ``` On 2022-10-12 13:37:48+0300, NSENGIYUMVA WILBERFORCE wrote: > I am using ubuntu(wsl) Please reply inline or inter-leaved. Perhaps this documentation can help you get started with building Git from source. (I suspect you're missing something like libcurl development files, too). https://git-scm.com/book/en/v2/Getting-Started-Installing-Git -- Danh ``` ## NSENGIYUMVA WILBERFORCE, 2022-10-12 16:37 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CA%2BPPyiE6e4NWGXS4WBzNteYdcNS_FW3beUq03uXx24guSDZYmQ%40mail.gmail.com In-Reply-To: ``` > Please reply inline or inter-leaved. > > Perhaps this documentation can help you get started with building Git > from source. (I suspect you're missing something like libcurl > development files, too). I am sorry, I was not minding about it, thanks alot for reminding me On Wed, Oct 12, 2022 at 6:18 PM Đoàn Trần Công Danh wrote: > > On 2022-10-12 13:37:48+0300, NSENGIYUMVA WILBERFORCE wrote: > > I am using ubuntu(wsl) > > Please reply inline or inter-leaved. > > Perhaps this documentation can help you get started with building Git > from source. (I suspect you're missing something like libcurl > development files, too). > > https://git-scm.com/book/en/v2/Getting-Started-Installing-Git > > -- > Danh ``` ## Christian Couder, 2022-10-13 10:52 Subject: Re: [Outreachy] internship contribution Message-ID: URL: https://gitlist.dev/e/CAP8UFD3PmuiXOVcDKC5ECrK_t69_9SLtxoAWSiiEGAGr7ikR8Q%40mail.gmail.com In-Reply-To: ``` Hi Ruqaiya, On Wed, Oct 12, 2022 at 5:30 PM Ruqaiya Sattar wrote: > > Hi , this is Ruqaiya, outreachy applicant December 2022 to March 2023, I am in construction phase now! I have no C programming experience, but I would love to learn and contribute to git.. Thank you for being interested in an Outreachy internship working on Git! It might be difficult to contribute if you have no C programming experience though. You might want to start learning it using books, tutorials or websites like https://exercism.org/ > can anyone help me how do a newbie get started contributing to git. I would suggest reading the following pages: - https://git.github.io/Hacking-Git/ - https://git.github.io/General-Microproject-Information/ Best, Christian. ```