Waypoint Ventures documentation

• Welcome
• Quick start
• Quick start
• Install software
• Set Git credentials
• Install Git client
• Install Git History extension
• Install Azure Repos extension
• Install Pull Requests extension
• Install Word Count extension
• Install Docs Authoring Pack
• Install Visual Studio Code
• Workflow and processes
• Test process
• Content editing process
• Instructional design review process
• Technical review process
• Authoring process
• General project workflow
• Terminology and concepts
• View/ download course files
• Fetch upstream changes
• Clone single folder
• Fix cloning errors
• Download course files (clone repo)
• Fork a repository
• View course files in web browser
• Working on branches
• Recover deleted branch
• Delete branch
• Rename branch
• Send (push) files
• Switch branches in VSC
• Update branch (pull) in VSC
• Create new branch in VSC
• Project branching policies
• Add/ edit content
• Create scaffolding
• Invite collaborator
• Fix linter issues
• Use author outlines
• Create new markdown file in VSC
• Add/ edit images in VSC
• Add/ edit markdown in VSC
• Add/ edit content in web browser
• Markdown syntax guide
• Pull requests and reviews
• Resolve merge conflicts
• Merge a pull request
• Work in a pull request
• Create pull request
• Pull requests overview
• Prepublication preparations
• Style a doc in Word
• Configure styles in Word
• Convert markdown to doc
• Setup file conversion tools
• About prepublication
• Appendices
• Links to useful resources
• Glossary
• FAQ
• Best practices guide

In this guide, you will download (or clone) a copy of the course files from AzDevOps onto your computer using the Visual Studio Code editor (VSC).

Topics in this guide

• Clone the AzDevOps repo

Clone the AzDevOps repo

Complete the following steps to clone the project’s repository (repo) from AzDevOps using VSC.

1. Open a web browser, go to the AzDevOps website at https://dev.azure.com, and sign in.

2. On the Projects tab, locate the project repo you want to clone, and select the Repos icon.

   For example, in the following image, the Repos icon for the project example-repo is selected.

   

3. Choose the Clone icon.

   

4. In the Clone Repository pane, set the IDE dropdown to Clone in VS Code.

   

5. In the Launch Application window, set the Send to option to Visual Studio Code, and then choose Open link.

   

6. When the Visual Studio Code editor (VSC) opens, choose Open if you’re asked to Allow an Extension to open this URI.

   

7. In the VSC file explorer, select a location on your computer for storing the cloned repo, and then choose Select Repository Location.

   For example, in the following image, the repo will be cloned into the folder C:\Windows\AzDevOps.

   

8. In VSC, wait for the Cloning git repository progress indicator to complete (lower right side).

   

9. If prompted, sign into AzDevOps/ Visual Studio.

   

10. In VSC, choose Open if asked Would you like to open the cloned repository, or add it…

    Note: In VSC, you can open a cloned repo from the top menu by using File > Open folder, and selecting the folder with the cloned repo.

    

11. The branch icon in the VSC status bar, at the bottom of the editor, indicates the name of branch that VSC is currently switched to.

    For example, in the following image, the branch icon in the VSC status bar indicates that VSC is currently switched to the branch named master.

    

    Note: To switch VSC to another branch, refer to the guide Switch branches.

12. Select the VSC Explorer icon, and use the VSC Explorer to choose a markdown file to open in the VSC Editor tab.

    For example, in the following image, the markdown file sample-file .md is open in the VSC Editor tab (right side), and VSC Explorer shows that the file is on the filepath ~/example-repo/sample-folder/ (left side).

    

You’ve cloned the project’s AzDevOps repo successfully.