Course functioning

[github-learning-lab]

Course functioning

Objective

It's important to establish that is not an expository course. Its objective is to teach participants about the VTEX IO Store Framework based on practical applications/activities. Therefore, in order to advance, you'll need to invest some time and dedication into it.

At the beginning of the course, you'll receive a repository containing a minimum amount of code our wish is that, upon completing all the tasks laid before you, you would have transformed that code into a fully functional store.

Intro

The course is divided into chapters. As each chapter begins, you'll receive initial instructions, just as you've already received for this and previous chapters. You should read through all of the presented content and perform the minor task set out at the end of the chapter.

For your answers to be sent, follow these steps:

1. Open a new window in VSCode
2. Execute CTRL + Shift + P or Cmd + Shift + P
3. Run git clone

4. Type in the repository's name, such as https://github.com/santosluiz000/store-framework
5. Confirm and select where you want to clone the repository
6. Click on Open on the notification that appears in the lower right corner

7. Open our test bot installation page and click on Configure;
   • ⚠️ Note that this bot differs from the GitHub Learning Lab bot. It's responsible for analyzing the answers coming from each course stage.
8. Select the Only selected repositories option, then click on Select repositories and type in store-framework;
9. Click on santosluiz000/store-framework and then on Install.

Submitting your answers

After reading the entire content and performing the wanted task, you should send your answer according to the steps below:

1. Click on Source Control, in the VSCode side menu;

2. Click on the + in the CHANGES section;

3. Compose a message that describes your change. For example:

4. Click on ✓ (Commit);

5. Click on the lower left corner;

6. When a new window appears, fill it in with the Branch name that was given at the beginning of the text and click on + Create new branch...;

7. Lastly, click on the cloud icon in the lower left corner:

Once you complete this flow, our bot will let you know whether your answers were correct or not. If yes, the reply will look like this:

Thereafter, you'll receive another reply highlighting the next steps:

If you're familiar with git, this entire flow is equivalent to creating a branch with a predefined name, committing changes and then executing a push.

Retries

Throughout the course, you may run into difficulty and not manage to correctly complete the activity on your first try. When this happens, you'll receive a feedback message that will let you know where you failed:

You can submit as many answers and you want by simply retrying the entire process explained in the previous section.
⚠️ In item 6 above, you won't need to retry everything, once the step's branch has been created. In item 7, instead of a cloud icon, you'll see several arrows, just click on them to resend:

Course progress

You may see your course progress at any time by going back to the main page. There, you'll see every step, what you've already completed, along with a button that takes you back to where you last stopped:

Don't forget to link

Anytime you open the VSCode terminal, you can run a vtex link to monitor the evolution of your project in https://{workspace}--{account}.myvtex.com. Make sure that the solution is visually comparable to what was presented and that no link errors occurred.

⚠️ Warning ⚠️

Do not create issues and PRs during the course flow, since this can interfere with its functioning.

---

To continue, click on Close issue

[github-learning-lab]

You have successfully completed this step!

Go to the next step!