microsoft / microsoft/generative-ai-with-javascript

feat/idea: add interactive choices [episode 01]

Open
#16 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
JavaScript
Stars
1.3k
Forks
841
Avg merge
1d 3h
Merged PRs (30d)
1

Description


🔹 1. Enhance the narrative experience with interactivity

Currently, the journey through time is engaging, but we can make it more dynamic and immersive by allowing users to make decisions or customize their experience.

  • Throughout the narrative, include small moments where the user can make decisions, which will then alter the Time Beetle’s response.
  • Example of an interactive choice in the README:
## 🚀 What do you do next?
You’re in Alexandria. Dinocrates needs your help. What will you do?
- 🔍 [Explore the Library for Clues](#exploring-the-library)
- 🛠️ [Start Building the Lighthouse](#building-the-lighthouse)
- 🤖 [Ask the Time Beetle for Historical References](#consulting-the-time-beetle)
  • Simple implementation using internal links within the README.

Impact: Makes the experience less linear, giving users more agency and encouraging greater participation.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the README and materials under lessons/01-intro-to-genai, linked from the issue. Review how the current narrative is presented, then define the choice points and their internal destinations. It is done when the lesson includes working choices that lead to distinct narrative paths and responses.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.