代码之旅
帮助学生理解新的代码库可能具有挑战性且耗时。创建足够描述性的说明可能很麻烦,而且对于学生来说仍然不容易遵循。CodeTour 可以帮助您以简化和交互式的方式向学生介绍您的作业和项目。
什么是代码之旅?
CodeTour是一个 Visual Studio Code 扩展,允许您通过代码库创建分步指南。这有助于在课堂上将作业分解为学生可以遵循的步骤,或者通过向他们指出作业中的相关部分来让他们熟悉作业的所有部分。
在下面的短视频中,讲师正在删除源代码中嵌入的现有说明,并将其替换为 CodeTour 步骤,以便学生可以在大型游戏开发项目中逐步跳转:
本质上,“代码浏览”只是一系列交互步骤,每个步骤都与特定目录或文件/行相关联,并包含相应代码的描述。游览可以签入存储库以与源代码管理共享,也可以导出到“游览文件”,这允许任何人重播相同的游览,而无需克隆任何代码!
案例分析
我们在 Microsoft 合作的太空大灌篮课程中使用了 CodeTour:使用篮球统计数据通过 Visual Studio Code 优化游戏玩法,灵感来自太空大灌篮:新的遗产
CodeTour 帮助引导自定进度的学习者完成模块 2,在模块 2 中,他们将创建一个 Web 应用程序,使用篮球统计数据在篮球场上做出决定。
以下是一名学生使用 CodeTour 开始开发篮球 Web 应用程序的短片:
CodeTour 入门
要开始使用 CodeTour,您需要从 VS Code Marketplace下载 CodeTour 扩展。