Skip to content

Latest commit

 

History

History
201 lines (137 loc) · 7.84 KB

README.md

File metadata and controls

201 lines (137 loc) · 7.84 KB
Raw

"The Magical Forest of Algora" Adventure

Table of Contents

Agenda

Prerequisites:

  • Active Github account
  • Copilot license that has been shared with you is already linked to your account
  • Wifi is connected, internet is working

If you do not have any of the above, pair up with someone that does have everything working.

Time Table:

Activities Duration
Gather, grab coffee, pair up & set up 10 mins
Learn about Copilot 5 mins
Explain Assignment 5 mins
Code! 45 mins
Demos & group discussion 15 mins

Setup

To get started, enter by clicking the button below. This will create a GitHub Codespace that you can work in. Once it loads select the Create codespace button.

Enter Adventure Arena

The Magical Forest of Algora

Introduction

Deep within the enchanted Forest of Algora, two mystical creatures, the Lox and the Drako, perform a sacred dance every millennium. This dance is not just for celebration but is a ritual to bring balance to the forest.

Objective

Your task is to simulate the dance between Lox and Drako. Each creature has its own set of dance moves, and the combination of moves creates various magical effects in the forest. Your goal is to determine the state of the forest after the dance is complete.

Specifications

Dance Moves and Effects:

  • Each creature can perform one of these dance moves: Twirl, Leap, or Spin.
  • Combination of moves from both creatures result in magical effects:
    • Twirl + Twirl = Fireflies light up the forest.
    • Leap + Spin = Gentle rain starts falling.
    • Spin + Leap = A rainbow appears in the sky.
    • Other combinations create different effects that you can dream up.

Dance Dynamics:

  • Each effect will change the state of the forest.
  • Some effects can be beneficial, while others can be detrimental.

Dance Sequence:

  • The dance consists of 5 sequences.
  • You need to display the state of the forest after each sequence.

Creature Moves:

Moves for Lox (Creature 1)

Sequence 1 Sequence 2 Sequence 3 Sequence 4 Sequence 5
Twirl Leap Spin Twirl Leap

Moves for Drako (Creature 2)

Sequence 1 Sequence 2 Sequence 3 Sequence 4 Sequence 5
Spin Twirl Leap Leap Spin

Advanced Features (if time permits):

- Implement a system that allows users to add new characters, dance moves and effects.
- Users can select the dance move for each sequence.
- Implement speech-to-text for selecting dance moves using Azure Speech Services.
- Visualize the forest using Azure AI DALLE-3.
- Animate visualizations if the above is not challenging enough.

Constraints

  • Use GitHub Copilot and write the simulation in any language you'd like.
  • Focus on clear and concise code that handles the dance dynamics efficiently. Ask GitHub Copilot/Chat, "How can I make this code more readable and maintainable?".
  • Creating a visual representation for the dance and effects is optional but encouraged if you have time.

Summary of High-Level Tasks to Perform

  1. Use a console application to render the output.
  2. Initialize the state of the forest.
  3. Each creature selects a dance move for each sequence.
  4. Determine the effect of the combined dance moves on the forest.
  5. Update the state of the forest after each sequence.
  6. Display the final state of the forest after the dance is complete.

Tips to Get Started

  1. If you're using a GitHub Codespace, you're ready to go!
  2. If running locally, ensure that you have your target language/framework installed.
  3. Create a folder for your code.
    • JavaScript: Create a folder called algora and add a file named app.js.
    • Python: Create a folder called algora and add a file named app.py.
    • C#: Create a folder called algora and run dotnet new console.

GitHub Copilot Tips

Use Copilot to improve efficiency

See if you can use Copilot to find out the complexity (BigO notation) of the code.

  1. Open the GitHub Copilot Chat view in the sidebar if it's not already open. Make sure your solution file is still open as well.

  2. Ask Copilot Chat what the complexity of the code is.

  3. Ask Copilot Chat to make the code more efficient.

  4. Ask for the complexity again - is it better?

Use Copilot to generate code comments

  1. Highlight all of the code with Ctrl/Cmd+A.

  2. Press Ctrl/Cmd+I to open the inline chat.

  3. Type "/doc"

  4. Ask Copilot Chat to document the function.

Use Copilot to simplify your code

  1. Open GitHub Copilot Chat in the sidebar.

  2. Type "/simplify" and press Enter. You can also add any text you want after the "/simplify" to give Copilot more instructions.

  3. What did Copilot Chat suggest you do to make it simpler?

Got Errors?

Copilot Chat can help with that too! Just copy the error message and paste it into Chat. Often that's all Copilot needs to resolve your issue.

Start Coding

Read Your Copilot Adventure description, the high-Level tasks to perform, and the GitHub Copilot hints to help you write your code.

  • Use GitHub Copilot and/or GitHub Copilot Chat to help you write the code for the adventure. You can use any language you'd like. Try learning a new language if you're up for the challenge (more on that below)!
  • Leave any comments in your code to explain your thought process and show prompts that GitHub Copilot used to help you out.

Submit Your Solution

If you'd like to share your solution with others, perform the following steps:

  • Publish your adventure solution to a GitHub repo.
  • Visit https://github.com/snw55/CopilotAdventures/issues and select New Issue.
  • Add a link to your GitHub repo in the body section.
  • If you have any feedback, share what you found (good or bad). We'd love to hear your feedback!

Intel

  • Try and only use your Codespace and Copilot
  • Questions or stuck? Ask us!
  • Example solutions can be found in /Solutions folder
  • Copilot shortcuts
    • CTRL - SHIFT - I: Workspace prompt
    • CTRL - I: Inline prompt, also works on code selection.
  • Copilot commands
    • /doc /explain /fix /generate /help /optimize /simplify /tests
  • Azure Speech: key/region
  • Azure AI DALLE-3: endpoint/key