GitHub Classroom: Creating Assignment Repositories with Forks Beta Update

[RyanHecht]

Hi everyone,

Thank you to all the teachers who opted in to the Public Beta for creating student repositories with forks! Your feedback has been invaluable as we decide on our path forwards.

In our feedback survey, you told us how useful being able to update student assignments is to your workflows.

However, you also told us your frustrations with setting up your assignments in light of some of the important changes we shared in our beta announcement, particularly:

• Manually needing to turn on forking private repositories for your organization is an annoying additional setup step
• Assignment visibility being tied to the visibility of the starter code restricts flexibility in how you store your starter code
• Giving students access to the upstream starter code in order for them to "Sync changes" makes it too easy for them to accidentally PR their changes upstream, exposing their work to other students
• Directly forking student repositories from the starter code means the starter code repository's commits are no longer automatically squashed, potentially exposing answers to the assignment through the commit history

We have planned changes to address these (and more) concerns brought to our attention during the Beta. You might see these changes as they're implemented if you're opted in to the Beta:

• Classroom will require that your provided starter code is a template repository. When you create your assignment, Classroom will create a new repository from the template with the visibility you select, and use THAT as the base from which student repositories will be forked. This will reinstate your ability to choose assignment visibility when you create a new assignment.
• Classroom will not give students "read" permissions to the upstream starter code repository; instead, teachers will have a button on the assignment dashboard in Classroom that will check for changes and open Pull Requests in all student repositories. Students can then accept the changes from their own repositories. This prevents any possibility of students opening pull requests upstream where their work is revealed to other students
• Classroom will inform you if forking private repositories is turned off for your organization when you select "Private" visibility for your assignment. If you choose to continue, Classroom will automatically change this setting in your classroom's GitHub organization
• Classroom will give you the choice to copy all branches to student assignment repositories, or just the default branch

These changes will start rolling out to current Beta participants in the coming weeks. We anticipate generally rolling out these changes (and moving everybody to the new assignment repository creation strategy) on July 1, 2024.

Thanks again for all your feedback! I'm heading out of office tomorrow, but will be back on the 19th to answer any questions you all have!

[HashmalTech]

no

[1iox]

ok

[Kangoma5]

Thank you for swift action to remedy the difficulties faced

[JoeSaf]

okay

[Danny-1103]

okay

[ST10448181]

ok

[magitz]

My classroom, which is opted into the beta, is having an issue where workflow actions that are part of the template are not showing up in the student repos as runnable. If they edit the .github/workflows/___.yml file, even just adding a space, the workflow shows up in the list of runnable actions.

[nick-bennett]

We're having the same problem; not looking forward to the prospect of this still happening for my students' next practical exam.

[euangeleo]

A +1 to this problem. Our template repositories use GitHub Actions for autograding, not the GitHub Classroom tests. Actions seem not to be enabled on the new forked repositories by default. It is not an improved system if we then need to manually go into each student's repository to enable Actions again, so that they can run the tests.

[euangeleo]

FWIW, this now seems to be fixed for my currently active class. New repositories that students create using the GitHub Classroom link for this assignment are now being created with the Actions enabled, and tests being run without me needing to manually do anything. Thanks, whoever was responsible for that fix!

[graphics80]

This issue still exists, but in a different way... The actions are enabled, that is true....

But we are no longer able to run an action when the student repo is created. We used to have an action that would copy issues from the template repo or get some files with student-specific config for anti-cheating checks...

[marcel-suter-bzz]

Also, any action with a manual dispatch, i.e. "on: workflow_dispatch", won't show up until you edit and commit the .yml file with the workflow.

[infoyouth]

Question??
In my new class room i am trying to select a template repo of my own public repo, but it says.
Errors updating assignment. Starter code repository must have at least one commit. Select a repository with commits or create the assignment without starter code.

I checked visibility settings/commits all look good. but still facing that error

[marcel-suter-bzz]

This happens to me when I create a new, empty repo and try to use it as the template. Did you check that your repo has at least one commit?

[onokajames96]

why is it that after forking the repository i cant stiil push is there i way the accees can be chnaged in that students can easily submit or commit their

[ctnelson1997]

Thank you!

[w0244079]

This is all great...but given that we're back to template repositories to a certain degree, would it be at all possible to provide the ability to have starter code from another private organization? This was removed a number of years ago so now my workflow is this....

Maintain a gold copy of my assignment in a non-classroom organization
Fork the gold copy to any classroom organization that might need it so that the it is available to the classroom as starter code.
Create the assignment from the starter code which now creates a copy of my fork in the same repository due to the template requirement.
I essentially have two repos of the same assignment in the classroom organization.

Could it be possible to be able to use starter code from another private organization that I also own like before so that at least I only have one repository in the classroom repo instead of two?

Thanks,
Michael

[pranavpatel08]

Thank you Michael!
seems like this is the only way for it to pick up the starter repo properly.
However, I am still facing some issue with the autograding. Got any loopholes around that?

[fuhrmanator]

I second @w0244079's request. I don't like any "gold copy" to be in the same org where TAs are owners (TAs are students). I'm not sure this requirement was considered in the current solution.

Otherwise, if there was a way to prevent TAs from having all the permissions (e.g., to delete repos) in the classroom organization, it could mitigate the risk.

[ViktoriiaBukhanets]

Hello dear community!
I have the following issue: when I try to create a new assignment based on repository, this repository has to be a template. But even when I am changing it to template, the error while creating the assignment still preserved. "Errors updating assignment. Starter code repo could not be copied to your organization ". Sometimes I also get "Errors updating assignment. Starter code repository must have at least one commit. Select a repository with commits or create the assignment without starter code". For my colleagues in the organization it does not seem to be a problem even if repository is not a template. Could someone give advises which settings I should check or what could be the issue.

Thanks,
Viktoriia

[nick-bennett]

In my opinion, this is a clumsy step in the wrong direction.

I have a curriculum org, with assignments and solutions in private template repos; I then create an org for each cohort of students I teach. When I create a student assignment, I first create a new repo (from one of the templates in the curriculum org) in the student-cohort-specific org, make the new repo a template, and then use that as the starter repo for the assignment.

I opted in to the new assignment system (with forked student repos) last month; as of one week ago, all of the above was still working fine. But yesterday when I did this, another repo was then unnecessarily created in the student cohort org (as described above in the update post), with a crazy long name (created from the concatenation of a slugified form of the descriptive name of the student cohort org, the name of the repository that I specified as the source, and the name of the assignment), and that unnecessary repo is used as the started repo for the student assignments. This is all as described above—and it's ridiculous. If this is the way this will work, why not go back to what we had a couple years back, where we could select a private template repo from another org as the assignment source? The classroom bot could then create a source repo in the student cohort org from that curriculum org template, and student forks could come from that source repo; at least that would eliminate the duplicated repos in the student cohort org.

Is there utility in having student assignment repos be created automatically as forks of the source org? Of course. However, there are many cases where that is overkill, and creating a student repo from a template (but not as a fork) is entirely sufficient; in working around some of the obvious potential issues with making the student repos forks of the source org, this latest update seems to be a kludgy acknowledgment of this, while complicating the situation for all GitHub Classroom assignment creators.

[pmcstjean]

+1 on this, the "copy" is useless for my workflow. I am disappointed that we cannot continue to opt-out of this feature, or have the ability so that the students fork directly from the template

[marcel-suter-bzz]

, this is a clumsy step in the wrong direction

I share your opinion on the current solution. I have been using GitHub Classroom for a number of years.

• Before: Students receive a copy of the template: This worked well. If I messed up and needed the students to update a file, it had to be done manually.
• Beta: Students fork the template (only during beta): This was near perfect and I was very happy with this solution.
• Current solution: For me this combines the weaknesses of both former solutions with hardly any benefits.

My request @github:

... the ability so that the students fork directly from the template

[marcel-suter-bzz]

@RyanHecht Would it be possible to have both options when creating a new assignment?

• Create a copy of the template and create student repositories from there (current behaviour)
• Create student repository from the template (like during the opt-in beta)

In the UI to create the assignment there could be a checkbox/dropdown to select one option or the other.

[robwhess]

I'll just chime in and say I agree that the new behavior of creating an intermediate repo to serve as the base from which student repos are forked does not seem like a very good solution to me. I don't understand what problem is being solved by this approach, and it makes maintenance of starter code a lot more challenging. As others have mentioned, now if I want to change something in the assignment after it's released (e.g. fix a bug in the starter code or clarify something in the README), I need to change it in two places: the original template repo from which the intermediate repo was created and then the intermediate repository itself. Updates to the intermediate repo require me to do the extra work of cloning that repo so I can maintain it alongside the original template repo. As we try to teach our students, this approach also introduces added possibility for making mistakes when trying to make the same changes in two different places.

Like others, I'd much prefer to at least have the option to have student repos forked directly from the original template repo (i.e. the behavior from the opt-in beta version of this feature). Then any updates I need to make after releasing the assignment can be made in one place.

[Ahasunhabib]

agree

[DavidMutchler]

Help! I have read the updated instructions. I have been using the new system since June 1. Everything worked for me a few days ago (after the change to the system making a COPY of my template to use as the starter code from which to fork). When I went to create a new assignment Friday, it failed with the message "Starter code repo could not be copied to your organization". That behavior continues today.

As a temporary workaround, I reverted my classroom to the old system. (I then had to change all my starter repos previously created to be templates, for the sake of students who are behind.) But if this problem is not fixed before the final rollout, it will be a disaster for me. *** I STRONGLY RECOMMEND DELAYING the July 1 rollout until adequate testing of the system has been done. ***

Edit June 29: The new system seems to be working for me now. As others have noted:

1. Be sure that your own starter code is a template.
2. The new system makes a copy of that starter code and creates forks from that copy. The copy is oddly-named but the names for projects that students see are fine (and what you would expect).
3. When you are creating a New Assignment, watch carefully when given the option for the forks to be PRIVATE or PUBLIC (there are radio button options for these). Choose PRIVATE if you do not want students to be able to see each other's code. The default for the radio buttons MIGHT OR MIGHT NOT be PRIVATE (it varies for me).

[PalominoVidalCarlos]

I have the same problem, there is some solution?

[RyanHecht]

Hi folks! These issues should be fixed now with our GA release. Let me know if you're still encountering it!

[DavidMutchler]

Thanks for your work! Things are working OK, but I got caught by the following limitation:

The problem is that: (1) Github repository names are limited in length (to 100 characters, I think). (2) The new system creates a new repository named by appending the CLASSROOM name and the STUDENT-REPO-PREFIX-NAME and the STARTER-REPO name. Together, these sometimes exceeded the length limit and sometimes did not, hence my struggles above.

No problem for me now, but this seems likely to bite others.

[ffespechen]

ok

[ssardina]

GH Classroom fails systematically when performing sync in the student forks:

It creates some, very few, PRs. I have 150+ student forks and I have tried many times, it does the sync updates on < 10 repos every time I hit Sync.

Anybody has faced this issue? 😭

[chdesvages]

I'm facing the same issue currently at the same scale (150+ student forks) -- it makes this feature unusable.

[g-simmons]

I have encountered the same error message several times.

Class size ~175 students.

[ron-reaser]

This change might cause me to switch from GitHub Classroom to another solution this semester.

• The old template-based model from last year was fine. Students would get merge conflicts when attempting to fetch and merge my changes from upstream because their initial squash commit differed from mine; it was a headache but avoidable with careful instructions.
• The fork-based beta from earlier this year was great. Students wouldn't get merge conflicts because their history and my upstream history had the same initial commit. It also most closely modeled real world usage without artificial classroom constraints, in my opinion.
• This new model clutters my organization with an extra repository with a bizarrely generated name which students can't view, so the "forked from" link on their own repository page links to a 404, which is bad user experience. It's meaningless for me to push changes to my original template repo, because I'm now supposed to push them to the copied repo. If I push to the original, it reverts to the old template-based model but worse. I can't easily push to the copied repo because the history diverges from my actual local repo due to the squash commit. And pull requests have never ever been a part of my class workflow. Every option is bad for me.

I was very happy with the fork-based beta. It was the smoothest that GitHub Classroom has ever gone for me. This new model is now the most complicated and least feasible it's ever been. I don't know how I can keep using it. The only viable option is to release the full term project at the start of the semester and never push any updates to it, but that comes with academic integrity challenges, or use other stopgap measures like patches or direct edits on the copied repo through the webpage. Again, every option is bad for me.

I am also unsatisfied with having to redo my entire workflow every semester because there's some new process to learn. This is a cognitive load I don't need when prepping my course materials, nor is it good for my students.

[ron-reaser]

To follow up, I did in fact give up and won't be using GitHub Classroom or GitHub at all for my course this semester. I was unable to surmount the difficulties from this technical change.

[djholt]

I'm in the process of adapting to the late changes since the beta earlier this summer. I've found that I can manually rename the copied starter repo without breaking anything, which is good (the default naming convention for starter repos really needs to be reworked).

Now I've managed to make most critical workflows function as needed, with one urgent exception: the automatic pull request feature to update student forks does not consider non-default branches. This is a massive limitation for me. With the original forking behavior, this was not an issue. Now, it's impossible without manually creating a pull request for each student, for each branch, multiplicatively.

@RyanHecht Short of scripting via CLI, is there a workaround? I'd appreciate the advice.

[djholt]

Turns out, even GH CLI doesn't work, because it doesn't support creating a PR across repositories within the same organization. The API does work if you use the head_repo parameter, but the CLI doesn't appear to support this option.

[pmcstjean]

Good move, this semester is even worse. I see change every couple of weeks in the observed behaviour of templates. Someone is pushing update directly in production code and we have no notification whatsoever, no roadmap, no support.

[ctnelson1997]

I agree with @pmcstjean . A bad push a few weeks a go caused student's to lose access to their repositories, and there was no notification before or after this change. I would appreciate release notes when these changes go into affect, and notices when things go wrong. Luckily, students are very vocal when something isn't working, but I would appreciate knowing if it is something on my end or GitHub's end rather than having to parse through the errors myself, especially with the number of changes this past semester, making it even more unclear.

[marcusradell]

We have a critical regression for our setup;

Commits in forks aren't accounted for in the students' contributions.

For our students, we need to make sure that we can prove how much effort they put into the course. A lot of the commits come from the classroom assignments, and we have seen a significant drop in number of commits due to the use of forks.

The work-around we have right now is to push a copy to a private repository, which is a messy solution.

Is there a way to get back the student's contributions?

[AdityaSrivastava185]

Hello everyone please help me to solve this issue i am getting when i am trying to solve the assembly assignment on github flow course but i am getting this error please help to solve this

Github classroom autograding workflow

[atexcode]

where is the error log?

[AdityaSrivastava185]

Thanks @atexcode , but I solved it already

[DavidMutchler]

GitHub Classroom is failing for me today. I used it successfully all summer. Today, it creates the student's fork successfully, but then displays an Error 500 ("something went wrong") when it should display the URL of the student's fork. Is anyone else having troubles (or for that matter, NO troubles) with GitHub Classroom today?
... david mutchler

[Injamul2k24]

ok

[ctnelson1997]

@RyanHecht I use a public starter template that creates private repositories for each student, and when they push they get an incredibly confusing message that main is behind main. I get that this is because of the underlying technical implementation, but is there a way that this can just be hidden?

[ualjjcanada]

I also need an option to hide this confusing message:

This branch is 3 commits ahead of ...

[pmcstjean]

It is normal that students are 'ahead' of the base code you provided. It starts to be confusing for students when they are both ahead and behind.

[SillyFreak]

Unfortunately I also have to chime in with problems the new workflow causes for me.

tl;dr:

• I can't change the starter repo after the fact
• like many others, I don't need a separate copy of my starter repo and think it's relatively easy to give users the option
• updating starter code of an active assignment is not so easy with the new workflow either, and it could be made easier for many people

---

First of all, I have been unable to change the starter code to come from a different repository after the fact. For example, during creation I'd choose my-org/my-template which would then become my-org/classroom-slug-my-template. When choosing "edit" on the assignment, the repository input would have this value. I can search for a different repo, but updating the assignment will not actually do anything. As far as I could figure out, there are only two ways to change the starter repo after the fact:

• manually (force) push to my-org/classroom-slug-my-template
• delete the assignment and repo, and start from scratch

As long as I'm still editing the assignment and have not even passed out the link to it, this is strictly worse than just having "Update assignment" work.

My understanding is that the relatively cumbersome process of copying the template repo is mainly done to hide history that may contain solutions from students. Personally, I am perfectly capable of ensuring that myself and would prefer the option of skipping that copying step. Creating a new repo means overhead in a few ways (e.g. deleting the assignment now requires deleting the repo separately, I may need to clone the new repo/add a remote to some repo I have, etc.) and this overhead scales with the number of assignments. I don't want that unless I benefit from it.

I think the following would work well:

• the starter repo that you select is really the repo that students fork
• add a button "Make a copy of this repo for the starter code" to the assignment editing screen
  • explain that for this to work, the repo needs to be a template
  • allow modifying the name of the repo
  • when clicked, the template is copied and the selection is replaced
  • this means that the starter repo is still exactly what the selection shows

This provides the options people here want without removing the benefits for people that may have "messy" histories.

Regarding the ability to update the starter code after students have started the assignment: I haven't used that yet, but I feel this is greatly diminished by the fact that the starter repo is not connected to the repo where I actually develop the assignment (some comments here seem to say that). What I described above won't fix the situation for people that use the "Make a copy" button, but at least it will work for those that don't use the button.

[nimonian]

@SillyFreak

the starter repo that you select is really the repo that students fork
add a button "Make a copy of this repo for the starter code" to the assignment editing screen

That's how it used to work in the good old days before they messed it up with these "improvements"

[acbart]

I agree with this. Having a second repository get created is cumbersome, and requires a more complicated workflow. If at least it added my original repository as an upstream fork, I could sync from the github website. Now I'm going to have to figure out the proper way to keep those two repos in sync, using the command line...

[djholt]

I've got to say, complete silence from any GitHub PM on these issues and concerns is even more concerning than the awkward state things seem to be left in. This smells of abandonware or poor organizational management and transparency, at best. I'm left worried. @RyanHecht

[DavidMutchler]

This board is not monitored well, as you say. You might try emailing directly to GitHub support. I did so through our organization representative to GitHub and got back a response within a day.

[pmcstjean]

It seems that a new change has been deployed in the last week or so. I created an assignment from a private organization template and it doesn't create a copy now ! Students have their fork created directly from that repo instead of a copy. Don't get me wrong, that is what I want but it's not how it was working in the last months. What's going on here ?

[cfcurtis]

Edit: the button eventually showed up after a few hours. I'll leave this here in case others run into the same issue.

Is anyone else having trouble getting the "Sync assignments" button to appear, or is there a way to trigger it manually (through the CLI or otherwise)?

I just pushed an update to my template repo and can't open PRs automatically because the sync button is missing:

If I go to an individual student's repo I can create a PR manually, but that's painful.

[otredu]

I'm having this same issue today. The "Sync assignments" button is no longer where it used to be...

[g-simmons]

Same here.

[ctnelson1997]

All of a sudden my students are encountering a "Repository Access Issue", anyone else?

[ctnelson1997]

@RyanHecht It would appear that students accepting the assignment are no longer getting direct access to their private repository. This was not the same behavior last week, and I haven't seen any release notes detailing this change.

[ctnelson1997]

It is preventing students from beginning their work.

[acbart]

Yikes, I'm getting reports of this too. Major problem! I hope they have a solution soon.

[DavidMutchler]

I saw similar behavior yesterday. My workaround was to add the student manually as an owner of their repository. The behavior does NOT appear to be happening today, fwiw. So perhaps the problem has gone away on its own (which has been the case for other problems recently as well).

[acbart]

Yep, manually adding the students worked. Painful, since we had a few dozen students affected. But if it was a one-off, then it's not the end of the world.

In case anyone wants explicit instructions, feel free to steal what I've written here:

1. Go to the assignment in Github classroom
2. For any student who has not Submitted (or a specific student), click on the link to their Repository (on the right hand side)
3. Go to Settings (right-most side of header tabs)
4. Click "Collaborators and teams" on the left
5. If things are working correctly, the student should be listed under "Direct access". If they are not, then click "Add people"
6. Type the user's github ID. This will be part of the repository name (e.g., hw3-classes-objects-acbart would be acbart)
7. Click Add to repository
8. Choose Write from the roles and then submit
9. The user should now have access

[beak85]

You can just add them with write permissions as a collaborator. That is what the system gives them when it is working properly. *From:* David Mutchler ***@***.***> *Sent:* Wednesday, September 18, 2024 10:10 AM *To:* community/community ***@***.***> *Cc:* Matt Geiger ***@***.***>; Comment < ***@***.***> *Subject:* Re: [community/community] GitHub Classroom: Creating Assignment Repositories with Forks Beta Update (Discussion #127455) I saw similar behavior yesterday. My workaround was to add the student manually as an owner of their repository. The behavior does NOT appear to be happening today, fwiw. So perhaps the problem has gone away on its own (which has been the case for other problems recently as well). — Reply to this email directly, view it on GitHub <#127455 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AEBZEBFFAU4VCDF45PFLHCLZXGCU5AVCNFSM6AAAAABI3GRGAKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTANRYGIZTIOI> . You are receiving this because you commented.Message ID: < ***@***.***>

[beak85]

Ouch! I have quite a few too, but it only happened to two of mine this time. It seems sporadic. When it happened a few weeks ago it was a few more, but certainly not all of them. *From:* Cole Nelson ***@***.***> *Sent:* Wednesday, September 18, 2024 10:30 AM *To:* community/community ***@***.***> *Cc:* Matt Geiger ***@***.***>; Comment < ***@***.***> *Subject:* Re: [community/community] GitHub Classroom: Creating Assignment Repositories with Forks Beta Update (Discussion #127455) I have 400 students (: — Reply to this email directly, view it on GitHub <#127455 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AEBZEBC2IEGDGKO3BE2SE4DZXGE7RAVCNFSM6AAAAABI3GRGAKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTANRYGI3DGMY> . You are receiving this because you commented.Message ID: < ***@***.***>

[BenjaminMichaelis]

These changes will start rolling out to current Beta participants in the coming weeks. We anticipate generally rolling out these changes (and moving everybody to the new assignment repository creation strategy) on July 1, 2024.

@RyanHecht is there an update on when these changes are anticipated to be rolled out since it seems like the July 1 date was missed? I don't seem to be able to get into the Beta anymore, but want to use forking over templates.

[nick-bennett]

Those changes are in place. The process is now:

1. You still have to start with a template, which must either be public or located in the classroom org.
2. When the assignment is created, GitHub Classroom creates a new repo from that template, with an automatically generated name (including the sluggified org display name and template repo name).
3. When the assignment is accepted, a fork of the repo created in step 2 is created for the participant.

Thus, if you want to make changes (after an assignment is created) that can be pulled into the student repos, they need to be made to the repo created in step 2.

[BenjaminMichaelis]

Oh - I see that now, thanks. I think I was hoping there would be a setting to fork into students own profiles - same functionality as them manually forking (our existing workflow), but the added benefit of being able to manage/grade from GH classroom.

[vincentsijben]

anyone having trouble with the reuse assignment button, not sure if its related... i created new classroom, went to classroom of previous year, clicked reuse assignments, search for the new organisation, but cant find the newly created classroom :(

[graphics80]

When I did it, it fu**ed up big time. The Job used the new "template" as template for the new classroom. Generating a template of a template of a template, should i update 3 Versions now? Started all over and made all assignments new... It's time to get a good CLI for classroom, enabling us to automate the process the way we want...

[cfcurtis]

@graphics80 - I agree that the copies of copies are getting a little out of hand. I also just had a student accidentlly fork their own repo and then clone that, so they were pushing to a place I had no idea existed. We were able to reconcile by opening a PR and merging it in, but it would be nice if that couldn't happen.

There is a CLI extension with some limited functionality, but maybe that would be a good place to request or contribute additional features.