-
Notifications
You must be signed in to change notification settings - Fork 40
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Intro to GitHub content #99
Comments
Source material for this? Drop useful links here? |
Would be good to incorporate this reference https://guides.github.com/activities/hello-world/ |
Unidata Python Training site has a list of several existing resources: https://unidata.github.io/python-training/python/intro-to-python/ |
I'm going to assign this issue to myself and @ktyle because we've had some offline discussions about developing some "Intro to GitHub" material for Kevin's class that's starting next week. |
@ktyle , @brian-rose, the Earth Cube Technology and Architecture committee has expressed interest in using this notebook for an internal proposal they are submitting to support Jupyter Lab hackathons. They (the TAC) want to know if it could be ready by end of October. What are your thoughts? |
@clyne the GitHub course material I've used in the class is not notebook-based ... I've slightly modified the content that is used in The Carpentries git-novice lesson and covered the first 9 "episodes" in the second and third weeks of this current semester. Throughout the rest of the semester, I have students use Git to push their assignments to the class GitHub space. Note that I don't devote any time to discuss pull requests, although I may work that in later this semester. Regarding your specific question, I think I'd need to hear a bit more about what the intent of the TAC proposal is. Are they looking to use GitHub for hackathon attendees? |
@ktyle the details of the TAC proposal are a little vague, but the basic idea is that TAC would solicit requests for hackathons around developing Python content in Notebooks. A service that TAC would provide to support these hackathons is training on technologies needed to develop and share notebooks. What's in it for us? Exposure for the project and an opportunity to get feedback from the TAC and possibly the hackathon organizers. |
@clyne We didn't get chance to discuss today, but has a decision been made about the TAC hackathons? |
We were supposed to hear by yesterday, but apparently they are still deliberating. I'd expect we'll know in a day or two. |
At the EWG today we struck ad-hoc "GitHub Gang" group to put heads together on this content in advance of the next Pythia hackathon. |
Notes from brainstorming session: BR: suggested outline Brainstorming ideas: |
@ktyle will take a first pass at setting up section headings for this in the first part of today's hackathon. Once we have that in place, we can more usefully divide up the rest of the work of creating the content. |
We got word today that the TAC hackathon proposal was awarded. I will reach out about a more reasonable target date for having a draft of out GitHub content in place. |
The deadline for the draft GitHub content is November 30. cc: @ktyle , @brian-rose |
Just updating this thread. With #169 merged, we have a coherent outline in place. The big need now is to actually flesh out content for some of these sections in Foundations. Let's try to discuss strategy for this at the beginning of today's hackathon. |
Our current action plan is as follows:
Once the first few parts are in place, that should set the scene for more advanced parts and we can distribute some of the work around the team. |
@SimonGoring perhaps you can view the extended outline that is now live here and provide feedback that would help us prioritize the remaining GitHub chapters for the TAC hackathons |
Is there any part of this I can help with? If anyone no longer has time for part 1, 2, or 4 or wants any amount of assistance please let me know @ktyle @r-ford @brian-rose |
Update: we had a meeting today with @ktyle, @clyne, @r-ford, @jukent and myself to strategize on how to get this done quickly. Here's a few things we decided:
|
@ProjectPythia/education please be aware that we are trying to pursue a vastly accelerated review cycle this week to get this work done. It would be extremely helpful if you can follow your notifications and respond quickly to review requests, even if just to say that you don't have time to do the review. Thanks! |
Ok here's another update with some milestones. I'll list the chapter headings, indicate current status, link the relevant PRs, and check things off when they get merged. edited with updates as of 1/19/2022
|
Would advanced topics include how to avoid and resolve merge conflicts? |
@jukent Yes definitely! |
Probably a whole laundry list of potential advanced topics ... |
Please!!! |
I noticed that the Contributor’s Guide already has a detailed guide on how to "contribute to Project Pythia via GitHub." Is there anything not already there that we would want in that section of this tutorial? Maybe just a walk through actually submitting an issue or PR with screenshots? |
There are lots of ways to "contribute" to Pythia, such as participating on the discussion forum. IMHO these lower bar contributions are covered adequately elsewhere. Perhaps this section would be a good place for an example (or two) showing how to contribute actual content (e.g. a correction to a notebook, or even a new notebook)? |
We should to a top-to-bottom review all of the content in this book chapter before closing this issue |
Yes, I created a new issue #214 for this! |
All related issues and PRs are now tagged with the "GitHub content" milestone. Hopefully that makes it easier to keep track of things. |
I think we can close this lengthy issue. All of the outstanding items are included in #214. Ok to close @brian-rose, @ktyle, @jukent ? |
Foundations is currently missing "intro to GitHub" content here.
The text was updated successfully, but these errors were encountered: