Skip to content

Latest commit

 

History

History
96 lines (66 loc) · 8.35 KB

technical-onboarding-instructions.md

File metadata and controls

96 lines (66 loc) · 8.35 KB
Raw

Technical Onboarding Instructions

Section 0: Prerequisites

To get started, complete the following items if you haven’t already:

By completing this Technical Onboarding Process, you will grow your skills with Azure, you will:

  • Become trained on the use of GitHub including GitHub Codespaces and GitHub Copilot
  • Complete one of the requirements for Student Ambassador program advancement
  • Create your very own personalized Portfolio website
  • Get a certificate that will recognize your new technical abilities!

As you are navigating Technical Onboarding, please reference Technical Onboarding GitHub Discussions to ask questions and/or share issues you encounter. Make sure to review other Ambassadors’ questions to help or get help!

Note: Technical Onboarding was updated on April 18, 2023. See this Discussions post for more details #27

Section 1: Create your own JavaScript Portfolio Site with GitHub Codespaces and Copilot

Why do this section?

Microsoft Cloud Advocates have created a template GitHub repository (or repo) for Microsoft Learn Student Ambassadors to use for this Technical Onboarding experience. This template not only includes your own version of some starter code, but also an entire starter development environment in GitHub Codespaces. You don't have to do any setup yourself with the power of Codespaces, it's all done for you!

In this exercise you will:

  1. Set up your GitHub Codespace
  2. Create your Portfolio site
  3. Customize your site with GitHub Copilot
  4. Explore how to deploy your site to the cloud with Azure Static Web Apps

A static web app (SWA) is a site built with JavaScript, HTML, CSS and potentially other tools, and SWAs are becoming increasingly common. Using Azure Static Web Apps will allow you to quickly post your Portfolio site to the world. Learn more about Static Web Apps in this Microsoft Learn module.

You can find the template repository and instructions to create your own Portfolio site here: https://github.com/education/codespaces-project-template-js

Section 2: Complete Your Next Step in GitHub Training with Reviewing Pull Requests

Why do this section?

By completing this Microsoft Learn Module, you will learn the foundation of collaboration on GitHub – one of the most popular platforms for collaborative development. To cite GitHub directly, “This course will dive into how you can get your best work done by identifying when and how to request a review, how to perform a review for someone else's pull request, and other awesome collaboration methods. All great projects start with collaboration. Pull requests are the foundation of teamwork on GitHub — and pull request reviews give you the ability to work together and discuss changes specific to a pull request by commenting, requesting changes, or approving.”

  1. Navigate to the "Manage repository changes by using pull requests on GitHub" Learn module

  2. Complete all 5 units, including the exercise on GitHub in unit 3 and the Knowledge Check in unit 4. The exercise will require you to log in to your GitHub account

  3. Navigate back to the Learn module page to confirm you have completed all steps of the module which will look like the image below:

  1. Confirm that the pull request you have been interacting with has been merged on GitHub. The URL will be https://github.com/<YOUR_GITHUB_ACCOUNT_NAME>/skills-review-pull-requests/pull/1 with the title “Update the game over message”. You should see the “Merged” status at the top of your pull request like the image below:

Section 3: Submit your onboarding details, feedback, and get your certificate of completion

You’ve made it to the end! The last step is to fill out the Onboarding Completion Form (using your @studentambassadors account) to provide a few details about you, your Profile site, the link to your final pull requests from the GitHub Learn module, and your experience with this process.

You will be advanced to the Beta milestone (once you have also hosted an event or actively participated in a social impact league project) after a Program Team member verifies that:

  1. Your Student Ambassador Profile is updated with your GitHub Account
  2. Your Portfolio site is complete and deployed with Azure Static Web Apps
  3. Your Github Learn module is complete.

Thank you for completing this exercise!

Optional: Creating an Azure Static Web App from an existing GitHub respository

Video demonstration: https://youtu.be/koA61KD6VzM

If you would like to create an Azure Static Web App from an existing GitHub respository on your GitHub account, you can also do that.

  1. Navigate to Azure and log in.
  2. Search for Static Web Apps and choose Static Web Apps
  1. Click 'Create'
  1. Choose your Azure subscription (yours may be called Visual Studio Enterprise or Azure for Students), then click Create New for your resource group and give it a name, for example AzureStaticWebAppDemo
  1. Give it a name, choose Free for the plan type and choose a location close to you
  1. Under deployment details choose GitHub, and 'Sign in with GitHub'
  2. Choose your organisation (your account), and your respository, you can leave Build presets blank, and then click 'Review + create'
  1. Choose React as your Build Preset
  • Change Build Presite
  1. Change the output location from the default build to dist
  • Change Build location
  1. Click 'Go to Resource' once it has finished deploying, and you should have a link which you can navigate to, to visit your website
  1. Navigating to your respository you can see your action has been created for you, once it has finished running you can refresh the link you visited and it should be deployed