microsoft · softchris · May 20, 2025 · May 20, 2025 · May 20, 2025 · May 20, 2025
diff --git a/lessons/01-intro-to-genai/README.md b/lessons/01-intro-to-genai/README.md
@@ -10,7 +10,7 @@ In this chapter you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
 [![Watch a short video about an Introduction to Generative AI](https://img.youtube.com/vi/vLYtDgs_zx8/0.jpg)](https://www.youtube.com/watch?v=vLYtDgs_zx8&list=PLlrxD0HtieHi5ZpsHULPLxm839IrhmeDk&index=1)
 
@@ -26,7 +26,7 @@ Moreover, Generative AI has evolved into multimodal capabilities, allowing you t
 
 *Simply put, natural language interfaces are becoming the new standard interface for many apps—and your users expect to use them.*
 
-## Narrative: A journey through time
+## Narrative: A Journey Through Time
 
 > [!NOTE] 
 > Let’s begin with an overview of the story—one that bridges the past and future! As you progress through this curriculum, you'll embark on a thrilling adventure, traveling back in time to collaborate with some of history's greatest minds. Together, you'll tackle challenges and explore how Generative AI can revolutionize your JavaScript applications._
@@ -36,7 +36,7 @@ Moreover, Generative AI has evolved into multimodal capabilities, allowing you t
 
 Your journey begins in 1860s London, where you assume the role of a skilled mechanic. Through a series of gripping adventures, you'll refine your AI skills and unlock solutions that transcend time.
 
-### Into the maelstrom - London 1860
+### Into the Maelstrom - London 1860
 
 In the heart of 1860s London, you are recognized as one of the most skilled mechanics of your time. Your workshop is tucked away in a narrow alley. The walls are lined with shelves overflowing with mechanical parts, blueprints, and half-finished projects.
 
@@ -48,7 +48,7 @@ Your workbench, the heart of your workshop, is an organized mess.
 
 _At the center of the bench lies the torso of a robot—an engineering marvel that has consumed months of effort. Its wooden frame is intricately carved, each joint meticulously designed for smooth movement._
 
-### A letter, for you?
+### A Letter, For You?
 
 Suddenly, a knock at the door disrupts your thoughts. Visitors at this hour are rare. Wiping your hands on a rag, you approach the door, curiosity piqued. 
 
@@ -62,7 +62,7 @@ _Yours,_
 
 _Charles Babbage."_
 
-### Off to the library
+### Off to the Library
 
 Charles Babbage, the great mathematician and inventor of the difference engine, wants to meet you. Quickly, you grab your coat and head out the door.
 
@@ -78,7 +78,7 @@ As your eyes adjust to the dim light, you notice a figure in the distance, wavin
    <img src="./assets/library.png" alt="Dusty Library" width="300">
 </div>
 
-### What's this device?
+### What's This Device?
 
 Just as you step closer, a blinding flash erupts, and he vanishes.
 
@@ -180,7 +180,7 @@ If you want to interact with Dinocrates, run the [Characters](/app/README.md) ap
 > [!NOTE]
  > If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
 
-### Code sneak peek
+### Code Sneak Peek
 
 While there is still a lot more to cover in this Generative AI curriculum, let's take a quick peek at the AI code to begin learning about using JavaScript with AI.
 
@@ -235,7 +235,7 @@ Here's a step-by-step summary of what the function does:
 
 > **Note**: [GitHub Copilot](https://github.com/features/copilot) was used to generate this code summary. Generative AI in action!
 
-### What can Generative AI do for me and my Apps?
+### What Can Generative AI Do for Me and My Apps?
 
 > [!NOTE]
 > You've probably figured out by now that the time beetle works like an AI assistant that you can interact with using natural language, written or spoken.
@@ -292,7 +292,7 @@ Here's an example of a "chatbot application" in action:
 
 **Time Beetle:** Let's just say that you're in a unique position to interact with historical figures in a way that few others can.
 
-### JavaScript ecosystem
+### JavaScript Ecosystem
 
 **You:** So ecosystems you said, I'm just taking notes here, what about JavaScript and how is it different from other ecosystems?
 
@@ -346,7 +346,7 @@ Visit [Microsoft Copilot](https://copilot.microsoft.com), [ChatGPT](https://chat
 
 [Solution](./solution/solution.md)
 
-### Knowledge check
+### Knowledge Check
 
 **Question:** Which of the following statements about Generative AI and JavaScript are true?
 
@@ -356,6 +356,6 @@ C. Python is the only language used for AI development.
 
 [Quiz solution](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - [Generative AI JavaScript video series](https://aka.ms/genai-js)
diff --git a/lessons/01-intro-to-genai/solution/solution-quiz.md b/lessons/01-intro-to-genai/solution/solution-quiz.md
@@ -1,6 +1,6 @@
 ## Quick Quiz: Test Your Knowledge!
 
-### ❓ Question 1:
+### ❓ Question 1
 Generative AI can generate text, images, and even code.
 
 <details>
@@ -16,7 +16,7 @@ Generative AI is capable of generating a variety of content such as text, images
 
 ---
 
-### ❓ Question 2:
+### ❓ Question 2
 JavaScript can be used for both front-end and back-end development.
 
 <details>
@@ -29,7 +29,7 @@ JavaScript can be used for both front-end and back-end development.
 
 ---
 
-### ❓ Question 3:
+### ❓ Question 3
 Python is not the only language that can be used for AI development. It can be argued that Python is the most popular language for AI development, but other languages/frameworks like JavaScript, Java and Python are also a very popular choices for AI development.
 
 <details>

diff --git a/lessons/01-intro-to-genai/translations/README.zh-cn.md b/lessons/01-intro-to-genai/translations/README.zh-cn.md
@@ -163,7 +163,7 @@ _时间设备，"乔治"金属甲虫_
 
 > [!IMPORTANT]
 > 这完全是虚构的；这些回应是由 AI 生成的。
-> [负责任的 AI 免责声明](../../README.md#responsible-ai-disclaimer)
+> [负责任的 AI 免责声明](../../../README.md#responsible-ai-disclaimer)
 
 <div>
    <img src="../assets/dinocrates.png" alt="身穿托加长袍的迪诺克拉底" width="300">

diff --git a/lessons/02-first-ai-app/README.md b/lessons/02-first-ai-app/README.md
@@ -1,4 +1,4 @@
-# Lesson 2: Writing your first AI app
+# Lesson 2: Writing Your First AI App
 
 In this chapter you will learn:
 
@@ -10,7 +10,7 @@ In this chapter you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
 [![Watch a short video about large language models](https://img.youtube.com/vi/GQ_2OjNZ9aA/0.jpg)](https://www.youtube.com/watch?v=GQ_2OjNZ9aA&list=PLlrxD0HtieHi5ZpsHULPLxm839IrhmeDk&index=2)
 
@@ -490,7 +490,7 @@ Check out [Sample app](/app/README.md) to get started.
 
 [Solution](./solution/solution.md)
 
-## Knowledge check
+## Knowledge Check
 
 **Question:** What is the purpose of the context window in generative AI models? Select all that apply.
 
@@ -502,7 +502,7 @@ C. The context window determines how creative the AI's responses are.
 
 [Quiz solution](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - [Text generation](https://platform.openai.com/docs/guides/text-generation)
 - [JavaScript library for OpenAI](https://github.com/openai/openai-node/tree/master/examples) 

diff --git a/lessons/02-first-ai-app/solution/solution-quiz.md b/lessons/02-first-ai-app/solution/solution-quiz.md
@@ -1,4 +1,4 @@
-### ❓ Question:
+### ❓ Question
 
 ### What is the purpose of the context window in generative AI models?
 

diff --git a/lessons/02-first-ai-app/translations/README.zh-cn.md b/lessons/02-first-ai-app/translations/README.zh-cn.md
@@ -26,7 +26,7 @@ _这个视频向你介绍了被称为"大语言模型"（LLM）的 AI 模型，
 > [!NOTE] 
 > _我们的故事到目前为止：你是一位制造者，一位来自 1860 年代伦敦的工匠，使用一个名为时间甲虫（Time Beetle）的神秘装置穿越时空。你穿越历史长河，见证了亚历山大灯塔的建造，这是一个古代工程奇迹，你在迪诺克拉底和时间甲虫的帮助下参与了建造。_
 >
-> 如果你想从头开始了解这个故事并开始学习生成式 AI，请查看[第一课](../01-intro-to-genai/README.md)。
+> 如果你想从头开始了解这个故事并开始学习生成式 AI，请查看[第一课](/lessons/01-intro-to-genai/README.md)。
 
 > [!NOTE] 
 > 虽然我们建议你跟随故事（这很有趣！），但如果你更喜欢直接跳到技术内容，[点击这里](#与莱昂纳多互动)。

diff --git a/lessons/03-prompt-engineering/README.md b/lessons/03-prompt-engineering/README.md
@@ -1,4 +1,4 @@
-# Lesson 3: Prompt engineering
+# Lesson 3: Prompt Engineering
 
 In this chapter you will learn:
 
@@ -10,7 +10,7 @@ In this chapter you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
 [![Watch a short video about prompt engineering](https://img.youtube.com/vi/gQ6TlyxBmWs/0.jpg)](https://www.youtube.com/watch?v=gQ6TlyxBmWs&list=PLlrxD0HtieHi5ZpsHULPLxm839IrhmeDk&index=3)
 
@@ -58,7 +58,7 @@ Leonardo grabs the reins and you both leap into the carriage. With a sharp crack
 
 **You:** No, not Rome, home... home...
 
-A swirl of colours envelops the carriage, the world around you dissolving into a kaleidoscope of light.
+A swirl of colors envelops the carriage, the world around you dissolving into a kaleidoscope of light.
 
 ## Escape 
 
@@ -322,7 +322,7 @@ Then use the LLM to incorporate these inputs and leverage the chain of thought p
 
 [Solution](./solution/solution.md) 
 
-## Knowledge check 
+## Knowledge Check
 
 **Question:** What is prompt engineering? Select all that apply.
 
@@ -334,7 +334,7 @@ C. Prompt engineering is about training a model to recognize patterns in data.
 
 [Quiz solution](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - [Prompt engineering](https://en.wikipedia.org/wiki/Prompt_engineering)
 - [Prompt engineering fundamentals](https://github.com/microsoft/generative-ai-for-beginners/blob/main/04-prompt-engineering-fundamentals/README.md?WT.mc_id=academic-105485-koreyst)

diff --git a/lessons/03-prompt-engineering/solution/solution-quiz.md b/lessons/03-prompt-engineering/solution/solution-quiz.md
@@ -1,4 +1,4 @@
-### ❓ Question:
+### ❓ Question
 
 ### What is prompt engineering?
 

diff --git a/lessons/03-prompt-engineering/translations/README.bn.md b/lessons/03-prompt-engineering/translations/README.bn.md
@@ -373,4 +373,4 @@ C. **প্রম্পট ইঞ্জিনিয়ারিং হলো এ
 ---
 
 ### **প্রারম্ভিক প্রকল্প:**  
-শুরু করতে এই **[Starter project](/sample-app/)** ব্যবহার করো! 
+শুরু করতে এই **[Starter project](/app/README.md)** ব্যবহার করো! 
diff --git a/lessons/04-structured-output/README.md b/lessons/04-structured-output/README.md
@@ -1,4 +1,4 @@
-# Lesson 4: Structured output
+# Lesson 4: Structured Output
 
 In this chapter you will learn: 
 
@@ -10,7 +10,7 @@ In this chapter you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
 It's worth rewatching the video on prompt engineering as it lays the foundation for what you're about to learn in this chapter.
 
@@ -566,6 +566,6 @@ C. Generating unstructured text.
 
 [Quiz solution](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - [Generative AI with JavaScript video series](https://aka.ms/genai-js)
diff --git a/lessons/04-structured-output/solution/solution-quiz.md b/lessons/04-structured-output/solution/solution-quiz.md
@@ -1,4 +1,4 @@
-### ❓ Question:
+### ❓ Question
 
 ### What is structured output used for ?
 

diff --git a/lessons/05-rag/README.md b/lessons/05-rag/README.md
@@ -1,4 +1,4 @@
-# Lesson 5: Talk to your data with Retrieval-Augmented Generation (RAG)
+# Lesson 5: Talk to Your Data with Retrieval-Augmented Generation (RAG)
 
 In this chapter you will learn:
 
@@ -10,7 +10,7 @@ In this chapter you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
 [![Watch a short video about RAG](https://img.youtube.com/vi/xkFOmx5yxIA/0.jpg)](https://www.youtube.com/watch?v=xkFOmx5yxIA&list=PLlrxD0HtieHi5ZpsHULPLxm839IrhmeDk&index=4)
 
@@ -330,7 +330,7 @@ const text = Object.values(data.query.pages)[0]?.extract;
 
 [Solution](./solution/rag-www.js)
 
-## Knowledge check
+## Knowledge Check
 
 **Question**: What is the role of the retriever in a RAG system?
 
@@ -342,7 +342,7 @@ C. The retriever finds relevant information from external data sources.
 
 [Quiz solution](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - [Retrieval-Augmented Generation and Indexes](https://learn.microsoft.com/azure/ai-studio/concepts/retrieval-augmented-generation)
 - **Sample apps**:

diff --git a/lessons/05-rag/solution/solution-quiz.md b/lessons/05-rag/solution/solution-quiz.md
@@ -1,4 +1,4 @@
-### ❓ Question:
+### ❓ Question
 
 ### What is the role of the retriever in a RAG system?
 

diff --git a/lessons/05-rag/translations/README.zh-cn.md b/lessons/05-rag/translations/README.zh-cn.md
@@ -25,7 +25,7 @@ _这个视频解释了检索增强生成（RAG），这是一种帮助AI在其
 > [!NOTE] 
 > _我们的故事到目前为止：您是一位来自19世纪60年代伦敦的机械师。您正在研究您的自动机，收到了查尔斯·巴贝奇的一封信，最终带您来到一个图书馆，在那里您拿起了一个时间旅行装置。在时间旅行中，您来到了佛罗伦萨，在那里遇见了达芬奇。您还去了阿兹特克帝国，故事就从这里继续。_
 >
-> 如果您想从头开始了解故事，请参阅[第1课](../01-intro-to-genai/README.md)。
+> 如果您想从头开始了解故事，请参阅[第1课](/lessons/01-intro-to-genai/README.md)。
 
 > [!NOTE] 
 > 虽然我们建议您阅读故事（很有趣！），但如果您想直接跳到技术内容，[请点击这里](#interact-with-ada-lovelace)。

diff --git a/lessons/06-tool-calling/README.md b/lessons/06-tool-calling/README.md
@@ -1,4 +1,4 @@
-# Lesson 6: Tool calling
+# Lesson 6: Tool Calling
 
 Tool calling, also known as function calling, refers to enhancing your AI model by adding capabilities it previously lacked. The concept involves supplying meta descriptions of your functions, allowing the AI model to determine when a particular tool should be called based on a user's prompt. The idea is to provide it with meta descriptions of your actual functions and make the AI model point out when such a tool should be called given a user's prompt.
 
@@ -12,9 +12,9 @@ In this chapter, you will learn:
 
 If you haven't already, set up your development environment. Here's how you can do it: [Setup your environment](/docs/setup/README.md).
 
-## Related resources
+## Related Resources
 
-[![Integrating with function calling](./assets/11-lesson-banner.png?WT.mc_id=academic-105485-koreyst)](https://aka.ms/gen-ai-lesson11-gh?WT.mc_id=academic-105485-koreyst)
+[![Integrating with function calling](./assets/11-lesson-banner.png)](https://aka.ms/gen-ai-lesson11-gh?WT.mc_id=academic-105485-koreyst)
 
 _This video explains Tool calling, a method that helps the AI call your functions and thereby expand what it can do_
 
@@ -410,7 +410,7 @@ function getWeatherForecast(lat, long) {
 
 [Solution](./solution/solution.js)
 
-## Knowledge check
+## Knowledge Check
 
 **Question:**  
 What is the purpose of registering a tool with the AI model?
@@ -435,7 +435,7 @@ C. To allow the AI model to execute tools without requiring metadata.
 
 [Solution quiz](./solution/solution-quiz.md)
 
-## Self-Study resources
+## Self-Study Resources
 
 - Explains the [process of tool calling](https://learn.microsoft.com/en-us/semantic-kernel/concepts/ai-services/chat-completion/function-calling/?pivots=programming-language-csharp)
 - Tool calling in the [Langchain.js framework](https://js.langchain.com/docs/how_to/tool_calling/)

diff --git a/lessons/06-tool-calling/solution/solution-quiz.md b/lessons/06-tool-calling/solution/solution-quiz.md
@@ -1,4 +1,4 @@
-### ❓ Question 1:
+### ❓ Question 1
 
 ### What is the purpose of registering a tool with the AI model?
 
@@ -11,7 +11,7 @@
 
 ---
 
-### ❓ Question 2:
+### ❓ Question 2
 
 ###  What is the role of tool metadata in tool calling?
 
@@ -26,7 +26,7 @@
 
 ---
 
-### ❓ Question 3:
+### ❓ Question 3
 
 ### Why use tool calling?