Exercise - Migrating your repository to GitHub

Nicolas Anderson 60 Reputation points

There are no instructions or whatsoever, instruction is unclear and I am not sure what am I supposed to do here. And the repository says it is read-only as well. It is really confusing to follow. Please fix it. https://learn.microsoft.com/en-us/training/modules/migrate-repository-github/3-migrate-your-repository-to-github and the lab is this link https://github.com/githubtraining/migrating-your-repository

This question is related to the following Learning Module

Azure Training
Azure Training
Azure: A cloud computing platform and infrastructure for building, deploying and managing applications and services through a worldwide network of Microsoft-managed datacenters.Training: Instruction to develop new skills.
1,271 questions
0 comments No comments
{count} vote

Accepted answer
  1. Pradeep M 1,715 Reputation points Microsoft Vendor

    Hi Nicolas Anderson,

    Thank you for reaching out to the Microsoft Q&A forum. 

    I understand your confusion and I'll clarify the objectives of this exercise: 

    Objective of the Exercise: 

    The main goal here is to migrate your existing repository from another version control system (like Mercurial, Subversion, or another Git platform) to GitHub. This involves transferring your project’s history and files to GitHub using tools like the GitHub Importer. 

    Key Steps and Considerations: 

    Step1:Plan the Migration 

    Why Move to GitHub? :GitHub offers feature-rich tools and collaborative opportunities to enhance your project. 

    Important Considerations: Decide if you need to preserve all historical data, including issues, discussions, and pull requests. Review historical commit messages for sensitive information. 

    Step 2: Prepare the Project 

    Handling Binary Files: Remove unsuitable binary files or use git-lfs for large files. 

    Adding .gitignore: Create a .gitignore file to exclude unnecessary files from version control. Templates are available in the github/gitignore repository. 

    Step 3: Private or Public Repository 

    Visibility Options: Choose between private (limited access) or public (open access) repositories. Ensure compliance with licensing and code of conduct for public repositories. 

    Step 4: Complete the Import 

    Using GitHub Importer: Transfer your repository from its current version control system to GitHub. Follow the instructions in the Code tab of your repository for importing. 

     Addressing Your Concerns: 

    Read-Only Repository: If encountering a read-only status, verify permissions to ensure you can proceed with migration. 

    Clarity of Instructions: If any step is unclear, please specify which part for detailed guidance.  


    Seek Further Assistance: For specific issues or personalized help, consider posting on the GitHub Community board. 

    Review Your .gitignore File: Ensure your .gitignore file is correctly configured to maintain a clean repository structure. Utilize templates from the github/gitignore repository. if needed. 

    Please feel free to contact us if you have any additional questions. If you found this answer helpful, please click the "Accept answer/Upvote" button so it can benefit other members of the Microsoft Q&A community. 

    Thank you. 


    0 comments No comments

1 additional answer

Sort by: Most helpful
  1. Marcin Policht 17,615 Reputation points MVP

    Start with https://github.com/githubtraining/migrating-your-repository/blob/main/responses/01_make-a-plan.md and then proceed to the subsequent steps:


    and so on...

    Admittedly, there is plenty of room for improvement here ;)

    If the above response helps answer your question, remember to "Accept Answer" so that others in the community facing similar issues can easily find the solution. Your contribution is highly appreciated.



    1 person found this answer helpful.