Skip to content

Lab 1.1 ‐ Onboarding

Roy Cornelissen edited this page Nov 10, 2024 · 3 revisions

Objective

In this Hands-On Lab, you will visit our HOL repository on GitHub, create a new issue and obtain your own copy of the GitHub repo with the code for these hands-on labs. You will be working on your own repo in the following labs.

We recommend that you keep a tab open with this Wiki at all times, and perform the steps below in a separate tab or browser window.

Steps

Step 1:🧭 Find the right repository and create an issue

In order to go through the hands-on labs, you will need your own repository. This way, you can freely explore and try out new things without fearing that you will break things for other people.

We have created a template repository in our Xpirit Community Events organization. This organization is a GitHub Enterprise organization with all features you will need enabled. In the following steps, we will create a copy of the repository for you. This copy, which will still exist in our Xpirit Communities organization, will be called attendeello-<YourGitHubHandle>. All the rest of the exercises will be done in that repository.

To get you repository created, you need to create an issue in our template repository.

  • When you use the Signup template, there is already information pre-filled, like Labels, assignees and some description.
  • Give it a title and give a brief introduction of yourself in the description
  • Mention @roycornelissen and/or @vriesmarcel in the description
  • Click Submit new issue

Step 2:⏳ Wait for your issue to be closed

Your moderators will monitor the incoming issues and close them. By closing them, a GitHub workflow will provision a copy of the repo for you to work on.

The workflow will create a repository called attendeello-<YourGitHubHandle> in our organization and it will give your user Admin permissions to this repository.

If you are interested in what this workflow does, navigate to the .github/workflows folder and open the workflow file provision-env.yml.

Step 3: 👍🏻 Accept your invitation

  • After your repository has been provisioned, you should receive an invitation in your inbox. It will be in your email and also in the notifications (📥 icon top right, next to your profile picture on the GitHub website).
  • Accept the invitation labeled Invitation to join XpiritCommunityEvents/attendeello-<YourGitHubHandle> from ...

By clicking the Accept invitation button, you will be granted Admin permissions to your own repo and you will navigate to its homepage. Your repository can be found at: https://github.com/XpiritCommunityEvents/attendeello-<YourGitHubHandle>.

Browse around in your repository for a bit to get familiar with its structure.