search

wpilibsuite / frc-docs

Official FRC Documentation powered by Read the Docs
https://docs.wpilib.org
Other
145 stars 256 forks source link

Help New Teams With Multiple Programmers Learn About Github #2634

Open Suave101 opened 2 months ago

Suave101 commented 2 months ago

There should be a page on how to use Github besides just creating an account. If you have multiple programmers on a team then some teams may need to learn how to do pull requests and create issues. Maybe we could even have a wpilib sample code license and template repository. Also, we should be teaching teams how to create their own github organizations that they can also host their team website for outreach on github.io for free. Just food for thought!

jasondaming commented 2 months ago

You have seen this right? It has a whole lot more information than just creating an account and it links to official sources with even more information.

What would you want to see in a template repo? I am not really sure what we are gaining.

I think an article on creating a GH team and another on a team website would both be great, but both of these things are really already documented pretty comprehensively in other places. I am not sure what would be different from a robotics perspective from those guides?

Suave101 commented 2 months ago

"Creating a GitHub Organization" would be a great article for us to write a tiny bit on so we can link it to GitHub's official documentation. Also, we can write about GitHub pages. The gain here is accessibility for teams to more free tools. These tools can help teams code more collaboratively rather than one guy doing it all. Furthermore, these tools can help teams do more outreach with their own free website!

Suave101 commented 2 months ago

Also, we could possibly add links to team websites hosted on GitHub to inspire teams to create their own websites to further spread FIRST