githubtraining / uploading-your-local-project

Course repo for Learning Lab course "Uploading your project to GitHub".

Course: Uploading your project to GitHub

This repository powers the Learning Lab course Uploading your project to GitHub.

Every Learning Lab course is made up of:

• a course repository, and
• a template repository, but this one is special and creates an empty repository for the learner

The course repository is written in YAML and Markdown. The template repository could be written in any language that supports the learning objectives.

For more information on the goals of this course, check out the course-details.md.

Contribute

See something we could improve? Check out the contributing guide in the community contributors repository for more information on the types of contributions we ❤️ and instructions.

We ❤️ our community and take great care to ensure it is fun, safe and rewarding. Please review our Code of Conduct for community expectations and guidelines for reporting concerns.

License

All Learning Lab course repositories are licensed under CC-BY-4.0 (c) 2019 GitHub, Inc. The template repositories associated with each course may have different licenses.

When using the GitHub logos, be sure to follow the GitHub logo guidelines

uploading-your-local-project's Issues

Broken link to Protected-Branches and CODEOWNERS

Origin: https://github.community/t5/GitHub-Learning-Lab/Broken-link-mentioned-in-github-upload-issues-5/m-p/15594#M462

Response file: https://github.com/githubtraining/uploading-your-local-project/blob/master/responses/08_graceful-exit.md

This could be a potential bug. Or I am missing something obvious..

cc/ @beardofedu @hectorsector

Link to quick reference guide broken

Bug Report

Current behavior
In responses/00_make-a-plan.md, there's a broken link to a quick reference guide.

Reproduction
Steps to reproduce the behavior in the course:

1. Register for this course.
2. Try and click on the quick reference guide referenced in the first issue.

Expected behavior
The target guide should either become available or the link should be removed.

Possible solution
I don't think we have the quick reference guide any more (or it may be outdated at this point) so the best course of action might be to remove it.

Additional context
Reported by @klickerlebnis in the community forum

Link wrong in lesson

Bug Report

Current behavior

In the "Migrating your repository to GitHub" lesson in the "Plan the move" issue page in the "Your project is already on your local machine" drop-down, and in the " Doing a clean cutover" drop-down, there's a link to: https://lab.github.com/courses/uploading-your-local-project
This destination does not exist. I think it's been replaced with this lesson/link: https://lab.github.com/githubtraining/uploading-your-project-to-github
Hopefully this won't be too hard to fix. There may be other lessons that also refer to the missing documents.

Reproduction
Steps to reproduce the behavior in the course:

1. Take the course

Expected behavior
The link should be correct.

Possible solution
Update the link.

Additional context
Reported via contact form

Misspelled word in course-details.md

Bug Report

Current behavior
In course-details.md, one instance of "to" should be changed to "do".

Reproduction
Steps to reproduce the behavior in the course:

1. Go to the 'What you'll learn' section in course-details.md
2. The third bullet from the bottom of that section contains the error ("How to I move my existing project to GitHub?")

Expected behavior
Change "to" to "do" (should be "How do I move my existing project to GitHub?").

Screenshot

Https repository links give problems with 2FA

Bug Report

Current behavior
In responses/02_move-local.md {{ repoUrl }}.git is used to generate https links to the git repository. Https gave me problems when 2FA is already enabled.

Reproduction
Steps to reproduce the behavior in the course:

1. Enable 2FA
2. Start the course and arrive at 02_move-local.md
3. Use the provided links for instance in use command line: Type git remote add origin {{ repoUrl }}.git
4. Use your username and password.
5. Response: remote: Invalid username or password.

Expected behavior
I expect a way to avoid or resolve this problem in the course documentation.

Possible solution
Instead of only providing the {{ repoUrl }} also provide a SSH access method. This would have worked for me, but I already had my ssh-key based access enabled.
Otherwise, provide an option to self-diagnose and switch to a different access method.

Additional context
I understand that this is expected behaviour when 2FA is enabled and no personal access token is used. However, for a novice that has to have 2FA enabled because of an organisational policy, this is a step that they might get stuck.

Error: `git push -u origin main` vs `master`

Bug Report

Current behavior
Using the command line, step five creates an error:

5. Type git push -u origin main to push the files you have locally to the remote on GitHub. (You may be asked to log in.)

The result is:

error: src refspec main does not match any
error: failed to push some refs to 'https://github.com/hermionexyz/github-upload.git'

Possible solution
This works instead:

git push -u origin master

Additional context
I guessed this solution after seeing this StackExchange answer using master instead of main. The answer says master was deprecated in 10-2020, so I'm guessing this tutorial hasn't been updated.