CodeTour

帮助学生理解新的代码库可能具有挑战性且耗时。创建足够详尽的说明可能很繁琐,而且对于学生来说仍然不够容易理解。CodeTour 可以帮助你以简化且互动的方式向学生介绍你的作业和项目。

什么是 CodeTour?

CodeTour 是一款 Visual Studio Code 扩展,允许你创建分步指南,指导你完成代码库。这在你的课堂中很有用,可以将作业分解为学生可以遵循的步骤,或者通过将他们指向作业中的相关部分,让他们熟悉作业的所有部分。

在下面的简短视频中,一位讲师正在移除嵌入在源代码中的现有说明,并用 CodeTour 步骤替换它们,以便学生可以在大型游戏开发项目中逐个步骤进行学习:示例作业中的 CodeTour

从本质上讲,“代码之旅”只是一系列交互式步骤,每个步骤都与特定目录或文件/行相关联,并包含对相应代码的描述。可以将之旅检入到存储库中以与源代码管理共享,也可以导出到“之旅文件”,这样任何人都可以重播相同的之旅,而无需克隆任何代码!

案例研究

我们在 Microsoft 合作的空中大灌篮课程中使用了 CodeTour:使用篮球统计数据优化游戏玩法,灵感来自《空中大灌篮 2:新传奇》

Microsoft partners Space Jam coding lessons

CodeTour 帮助自学人员完成 模块 2,其中他们正在 创建一个 Web 应用,该应用使用篮球统计数据在篮球场上做出决策。

以下是一个学生使用 CodeTour 开始其篮球 Web 应用工作的简短片段: 太空大灌篮课程中的 CodeTour

开始使用 CodeTour

若要开始使用 CodeTour,你需要从 VS Code 市场下载 CodeTour 扩展。

CodeTour extension in Extension Marketplace

若要在课堂中有效使用 CodeTour,我们建议遵循 CodeTour 存储库 中的指南。