Skip to content

docs: docsify adjustments #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
May 30, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions lessons/01-intro-to-genai/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Lesson 1: Introduction to Generative AI and LLMs for JavaScript Developers
# Lesson 1: Introduction to Generative AI and LLMs for JavaScript Developers

In this chapter you will learn:

Expand Down Expand Up @@ -73,7 +73,7 @@ It's dark and gloomy inside, the only light filtering through the grimy windows,

As your eyes adjust to the dim light, you notice a figure in the distance, waving at you. You walk towards him, your footsteps echoing on the wooden floor. The figure becomes clearer, and you recognize him from newspaper photos, it's Charles Babbage.

![Dusty Library](/lessons/01-intro-to-genai/assets/library.png)
![Dusty Library](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/library.png)

### What's This Device?

Expand All @@ -87,15 +87,15 @@ Compelled by curiosity, your fingers drift toward the red button. The moment you

Then, blackness, and a sense of falling.

![Time Vortex](/lessons/01-intro-to-genai/assets/vortex.png)
![Time Vortex](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/vortex.png)

### Alexandria 300 BC

You awaken, disoriented. As your vision clears, an ancient city unfolds before you—bustling, vibrant, and alive.

People in togas move through the streets, their voices blending into a symphony of ancient dialects, air filled with the scent of exotic spices and the distant sound of merchants hawking their wares.

![Alexandria 300 BC](/lessons/01-intro-to-genai/assets/alexandria.png)
![Alexandria 300 BC](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/alexandria.png)

**You:** Surely, I must have hit my head, you think, closing your eyes and opening them again, scene remains unchanged.

Expand All @@ -105,7 +105,7 @@ Am I stuck in the past? Do I dare press that button again? Before you can decide

An elderly gentleman wearing a toga waves at you from the steps of the grand temple. His white hair and beard catch the sunlight, giving him an almost ethereal glow.

![Dinocrates wearing a toga](/lessons/01-intro-to-genai/assets/dinocrates.png)
![Dinocrates wearing a toga](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/dinocrates.png)

**Dinocrates:** "Welcome, traveler," he says warmly. "I am Dinocrates, architect of this great city. Your arrival was foretold."

Expand Down Expand Up @@ -135,7 +135,7 @@ A thought strikes you. Can the device understand me if I speak to it?

**You:** You're right, George is a good name, it was my father's name in fact.

![Time Beetle](/lessons/01-intro-to-genai/assets/time-beetle.png)
![Time Beetle](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/time-beetle.png)

_Time device, “George” the metallic beetle_

Expand All @@ -154,7 +154,7 @@ If you want to interact with Dinocrates, run the [Characters](/app/README.md) ap
> This is entirely fictional; the responses are generated by AI.
> [Responsible AI disclaimer](../../README.md#responsible-ai-disclaimer)

![Dinocrates wearing a toga](/lessons/01-intro-to-genai/assets/dinocrates.png)
![Dinocrates wearing a toga](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/01-intro-to-genai/assets/dinocrates.png)

**Steps**:

Expand Down
2 changes: 1 addition & 1 deletion lessons/02-first-ai-app/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ When you open your eyes, the world has shifted. As you manage to get up, you rea
Looking around the boat, you find a long oar resting against the side. Grasping it, you begin to row towards the distant buildings. As you get closer, the buildings come into sharper focus, they are old, their architecture reminiscent of a Renaissance painting.


!["Boat on the river, man standing with a paddle](/lessons/02-first-ai-app/assets/boat.png)
!["Boat on the river, man standing with a paddle](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/02-first-ai-app/assets/boat.png)

The question now is, where and when are you this time?

Expand Down
2 changes: 1 addition & 1 deletion lessons/03-prompt-engineering/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ _This video offers an introduction to improving your "prompting" skills, teachin

Before you manage to press the button, the workshop doors slam open with a thunderous bang. A man stands in the doorway, broad-shouldered and dressed in expensive clothes, he waves a piece of paper in the air, yelling:

!["An angry Ludovico Sforza busting in through the door](/lessons/03-prompt-engineering/assets/ludovico.png)
!["An angry Ludovico Sforza busting in through the door](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/03-prompt-engineering/assets/ludovico.png)

*Ludovico Sforza*

Expand Down
10 changes: 5 additions & 5 deletions lessons/04-structured-output/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ The bright light from the Time Beetle fades, and you find yourself standing at t

The aerial screw, rests awkwardly on a large, intricately carved stone, with markings that look like a calendar

![Aztec calendar, Wikipedia](/lessons/04-structured-output/assets/aztec.png)
![Aztec calendar, Wikipedia](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/04-structured-output/assets/aztec.png)

_Aztec calendar, Wikipedia_

Expand All @@ -56,7 +56,7 @@ Leonardo da Vinci steps forward, his eyes wide with wonder.

Before you can react, a group of Aztec soldiers approaches.

![Meeting with Aztecs](/lessons/04-structured-output/assets/meeting.png)
![Meeting with Aztecs](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/04-structured-output/assets/meeting.png)

**Soldier leader:** "Who are you, and what have you done?" he demands in Nahuatl.

Expand All @@ -78,7 +78,7 @@ Upon reaching the top of the pyramid, you are led into a grand chamber where Mon

**Montezuma:** "Very well. I propose a game of [Patolli](#patolli). If I win the best of three games, you will give me your device and tell me how it works. If you win, you are free to go."

![Playing a game of Patolli](/lessons/04-structured-output/assets/game.png)
![Playing a game of Patolli](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/04-structured-output/assets/game.png)

The game begins, and the room falls silent, save for the sound of beans being rolled and pieces moving across the board.

Expand Down Expand Up @@ -108,7 +108,7 @@ With a final, decisive move, Leonardo wins the game. The room erupts in cheers a
>
> **Aztec Involvement**: Widely played by nobles and commoners, it was a favorite at Montezuma’s court. Beyond fun, it involved high-stakes gambling with bets like blankets, precious stones, or even freedom.

![Patolli board](/lessons/04-structured-output/assets/patolli.png)
![Patolli board](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/04-structured-output/assets/patolli.png)

_Patolli - Wikipedia_

Expand All @@ -120,7 +120,7 @@ If you want to interact with Montezuma, run the [Characters](/app/README.md) app
> This is entirely fictional; the responses are generated by AI.
> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

![Montezuma](/lessons/04-structured-output/assets/montezuma.jpeg)
![Montezuma](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/04-structured-output/assets/montezuma.jpeg)

**Steps**:

Expand Down
10 changes: 5 additions & 5 deletions lessons/05-rag/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,14 +36,14 @@ _This video explains Retrieval Augmented Generation (RAG), a method that helps t

You land in the garden, it's late at night with a thick fog and eerie lights are flickering in the distance. The mansion looms before you. Leonardo looks around, his eyes wide with wonder.

![Old mansion shown in a deep fog](/lessons/05-rag/assets/mansion.jpeg)
![Old mansion shown in a deep fog](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/05-rag/assets/mansion.jpeg)


### Running from the Dogs

You hear barking and the sound of dogs running towards you. You turn to Leonardo, "We need to get inside, now!"

![Running from the dogs](/lessons/05-rag/assets/dogs.jpeg)
![Running from the dogs](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/05-rag/assets/dogs.jpeg)

As you reach the mansion's door it swings open and a pair of attendants hurry out. After sizing you up, they motion for you to follow them.

Expand All @@ -59,7 +59,7 @@ You come face to face with Ada Lovelace, her eyes gleaming with curiosity.

**You:** But..

![Ada Lovelace and Charles Babbage working on a device](/lessons/05-rag/assets/ada.jpeg)
![Ada Lovelace and Charles Babbage working on a device](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/05-rag/assets/ada.jpeg)

Charles Babbage steps forward, examining the Time Beetle in your hand. "This device is remarkable, but it's a bit faulty, isn't it? You've noticed, I'm sure."

Expand All @@ -79,7 +79,7 @@ If you want to interact with Ada, run the [Characters](/app/README.md) app.
> This is entirely fictional; the responses are generated by AI.
> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

![Ada Lovelace](/lessons/05-rag/assets/ada-2.jpeg)
![Ada Lovelace](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/05-rag/assets/ada-2.jpeg)

**Steps**:

Expand Down Expand Up @@ -124,7 +124,7 @@ At its core, RAG involves two main components: a **retriever** and a **generator

Here's a schema illustrating how a RAG system works:

![Schema of a RAG system](/lessons/05-rag/assets/rag.png)
![Schema of a RAG system](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/05-rag/assets/rag.png)

1. **User input:** The user asks a question.
2. **Retriever:** The retriever component searches for relevant information using one or more knowledge bases.
Expand Down
4 changes: 2 additions & 2 deletions lessons/07-mcp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ _Our heroes, having just learned about tools and "tool-calling" during their mee

The swirling of light envelops you again and you find yourself in a large room with a large table in the middle. The walls are adorned with maps and military strategies. Scipio Africanus is standing at the table, deep in thought. He looks up as you enter. "Ada te misit/Ada sent you?"

![Scipio Africanus](/lessons/07-mcp/assets/scipio.png)
![Scipio Africanus](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/07-mcp/assets/scipio.png)

> Scipio Africanus, also known as Publius Cornelius Scipio Africanus, was a prominent Roman general and statesman who lived from 236 BC to 183 BC. He is best known for his decisive role in the Second Punic War against Carthage and his victory over Hannibal at the Battle of Zama in 202 BC.
> His life and career exemplify the qualities of leadership, strategic brilliance, and resilience. His contributions to Rome's military and political spheres left a lasting impact on the Roman Empire.
Expand All @@ -59,7 +59,7 @@ If you want to interact with Scipio, run the [Characters](/app/README.md) app.
> This is entirely fictional; the responses are generated by AI.
> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

![Scipio Africanus](/lessons/07-mcp/assets/scipio.png)
![Scipio Africanus](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/07-mcp/assets/scipio.png)

**Steps**:

Expand Down
4 changes: 2 additions & 2 deletions lessons/08-mcp-advanced/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ You once again traveled back to Ada's mansion. This time Ada was meeting you at

Everything fades to black. Swirling colors rush past, and moments later, your vision begins to focus. You see a man sitting by a piano, animatedly talking with a woman who has dark brown and curly hair. Both are gesticulating excitedly as they speak.

![Hedy Lamarr](/lessons/08-mcp-advanced/assets/hedy-invention.jpeg)
![Hedy Lamarr](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/08-mcp-advanced/assets/hedy-invention.jpeg)

The woman turned around to face Ada standing next to you to exclaim "Ada it's you, it's been far too long".

Expand Down Expand Up @@ -86,7 +86,7 @@ If you want to interact with Hedy, run the [Characters](/app/README.md) app.
> This is entirely fictional; the responses are generated by AI.
> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

![Hedy Lamarr](/lessons/08-mcp-advanced/assets/hedylamarr.jpeg)
![Hedy Lamarr](https://raw.githubusercontent.com/microsoft/generative-ai-with-javascript/main/lessons/08-mcp-advanced/assets/hedylamarr.jpeg)

**Steps**:

Expand Down