search

ObieSource / obiesource.github.io

The ObieSource Website. Project Leader: Ajai Nelson
https://obiesource.github.io/
2 stars 22 forks source link

Contributors guide #11

Closed iosenberg closed 2 years ago

iosenberg commented 2 years ago

Wrote a contributor's guide for adding oneself to the website. Please feel free to edit for accuracy and clarity. Also added a template member page to obiesource.github.io/members/

FiskFan1999 commented 2 years ago

I would be open to the idea of making a video tutorial for how to fork the repo and submit a pull request, if you think that would help those who would prefer a visual/auditory tutorial

FiskFan1999 commented 2 years ago

I just put together this video tutorial for how to do the whole process.

https://spectra.video/w/grq4Zr6rofFbef5di5iSqa (still transcoding)

Of course it is your call to put it in or not, please feel free to say the video is trash and don't include it if you like :)

iosenberg commented 2 years ago

The video looks great! I'll link it in the file

AjaiKN commented 2 years ago

(I thought I made this comment already, but I must have forgotten to press submit or something.)

@FiskFan1999 Great job with the video!

The video uses make, but I don't think it mentioned installing make. Like with git and Python, I don't think make is preinstalled on Windows. (Again, I could be wrong.)

Also, maybe it would be easier to use the GitHub HTTPS link instead of the SSH one. That way, people don't need to configure SSH keys.

iosenberg commented 2 years ago

! I didn't realize make isn't installed by default on Windows! I just assumed it wasn't working and I didn't feel like troubleshooting, so I ran the command on my own. I'll install make and if it's easy enough, I'll add it to the tutorial

FiskFan1999 commented 2 years ago

Thanks for your comment on make, I’ll put that in the video description. As for using hit HTTPS I think that GitHub has disabled authentication for git over https so you’re not allowed to push via https. Correct me if I’m wrong on this…

Sent from my iPhone

On Apr 14, 2022, at 19:54, Ajai @.***> wrote:

 (I thought I made this comment already, but I must have forgotten to press submit or something.)

@FiskFan1999 Great job with the video! A couple comments:

The video uses make, but I don't think it mentioned installing make. Like with git and Python, I don't think make is preinstalled on Windows. (Again, I could be wrong.)

Also, maybe it would be easier to use the GitHub HTTPS link instead of the SSH one. That way, people don't need to configure SSH keys.

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you were mentioned.

AjaiKN commented 2 years ago

I'm pretty sure I use the HTTPS method, so I think it works for pushing. It looks like GitHub actually recommends the HTTPS method.

FiskFan1999 commented 2 years ago

I'm pretty sure I use the HTTPS method, so I think it works for pushing. It looks like GitHub actually recommends the HTTPS method.

Wow, thanks for telling me this. It turns out I was wrong because even though Github disabled authenticating over https via password in August last year, there are other methods of authentication, so it is still possible to push to your repo over https using Personal Access tokens, for which there is this tutorial.