From 5c1bc22bec7be8478bdd2f611e6eefb7553bbc7f Mon Sep 17 00:00:00 2001 From: meaghanlewis Date: Mon, 9 Nov 2020 10:51:50 -0800 Subject: [PATCH] add more metadata to module 1 --- get-started-with-go/0-introduction.yml | 2 +- get-started-with-go/1-what-is-go.yml | 4 +- get-started-with-go/2-install-go.yml | 4 +- get-started-with-go/3-explore-playground.yml | 10 ++--- get-started-with-go/4-install-vs-code.yml | 10 ++--- get-started-with-go/5-hello-world.yml | 6 +-- get-started-with-go/7-summary.yml | 43 +++++++++----------- get-started-with-go/README.md | 26 ++++-------- get-started-with-go/media/README.md | 4 +- take-your-first-steps-go/README.md | 9 +--- take-your-first-steps-go/index.yml | 17 ++++---- 11 files changed, 58 insertions(+), 77 deletions(-) diff --git a/get-started-with-go/0-introduction.yml b/get-started-with-go/0-introduction.yml index ec43e3a..3939a90 100644 --- a/get-started-with-go/0-introduction.yml +++ b/get-started-with-go/0-introduction.yml @@ -9,6 +9,6 @@ metadata: ms.topic: interactive-tutorial ms.prod: learning-azure title: Introduction -durationInMinutes: +durationInMinutes: 1 content: | [!include[](includes/0-introduction.md)] diff --git a/get-started-with-go/1-what-is-go.yml b/get-started-with-go/1-what-is-go.yml index aa686ac..70612d2 100644 --- a/get-started-with-go/1-what-is-go.yml +++ b/get-started-with-go/1-what-is-go.yml @@ -2,13 +2,13 @@ uid: metadata: title: What is Go - description: + description: Learn about the history and use cases of the Go programming language. ms.date: author: meaghanlewis ms.author: shanama ms.topic: interactive-tutorial ms.prod: learning-azure title: What is Go -durationInMinutes: +durationInMinutes: 2 content: | [!include[](includes/1-what-is-go.md)] diff --git a/get-started-with-go/2-install-go.yml b/get-started-with-go/2-install-go.yml index 1960dc7..e360751 100644 --- a/get-started-with-go/2-install-go.yml +++ b/get-started-with-go/2-install-go.yml @@ -2,7 +2,7 @@ uid: metadata: title: Exercise - Install Go - description: + description: Install Go for your operating system. ms.date: author: meaghanlewis ms.author: shanama @@ -10,6 +10,6 @@ metadata: ms.prod: learning-azure zone_pivot_groups: os title: Exercise - Install Go -durationInMinutes: +durationInMinutes: 5 content: | [!include[](includes/2-install-go.md)] diff --git a/get-started-with-go/3-explore-playground.yml b/get-started-with-go/3-explore-playground.yml index 5d3a768..a42ccf4 100644 --- a/get-started-with-go/3-explore-playground.yml +++ b/get-started-with-go/3-explore-playground.yml @@ -1,14 +1,14 @@ ### YamlMime:ModuleUnit uid: metadata: - title: Exercise - Install Go - description: + title: Exercise - Explore the Go Playground + description: Learn how to use the Go Playground by running your first program. ms.date: author: meaghanlewis ms.author: shanama ms.topic: interactive-tutorial ms.prod: learning-azure -title: Exercise - Install Go -durationInMinutes: +title: Exercise - Explore the Go Playground +durationInMinutes: 3 content: | - [!include[](includes/2-install-go.md)] \ No newline at end of file + [!include[](includes/3-explore-playground.md)] \ No newline at end of file diff --git a/get-started-with-go/4-install-vs-code.yml b/get-started-with-go/4-install-vs-code.yml index 5d3a768..96909b5 100644 --- a/get-started-with-go/4-install-vs-code.yml +++ b/get-started-with-go/4-install-vs-code.yml @@ -1,14 +1,14 @@ ### YamlMime:ModuleUnit uid: metadata: - title: Exercise - Install Go - description: + title: Exercise - Install VS Code and the Go Extension + description: Finish setting up your development environment with installing VS Code and the Go language extension. ms.date: author: meaghanlewis ms.author: shanama ms.topic: interactive-tutorial ms.prod: learning-azure -title: Exercise - Install Go -durationInMinutes: +title: Exercise - Install VS Code and the Go Extension +durationInMinutes: 6 content: | - [!include[](includes/2-install-go.md)] \ No newline at end of file + [!include[](includes/4-install-vs-code.md)] \ No newline at end of file diff --git a/get-started-with-go/5-hello-world.yml b/get-started-with-go/5-hello-world.yml index 74b53ed..2e46bec 100644 --- a/get-started-with-go/5-hello-world.yml +++ b/get-started-with-go/5-hello-world.yml @@ -2,13 +2,13 @@ uid: metadata: title: Exercise - Hello World - description: + description: Write your first Go program in VS Code. ms.date: author: meaghanlewis ms.author: shanama ms.topic: interactive-tutorial ms.prod: learning-azure title: Exercise - Hello World -durationInMinutes: +durationInMinutes: 5 content: | - [!include[](includes/3-hello-world.md)] + [!include[](includes/5-hello-world.md)] diff --git a/get-started-with-go/7-summary.yml b/get-started-with-go/7-summary.yml index f1e921d..ad4623c 100644 --- a/get-started-with-go/7-summary.yml +++ b/get-started-with-go/7-summary.yml @@ -9,51 +9,48 @@ metadata: ms.topic: interactive-tutorial ms.prod: learning-azure title: Summary -durationInMinutes: +durationInMinutes: 1 content: | - [!include[](includes/5-summary.md)] + [!include[](includes/7-summary.md)] quiz: title: Check your knowledge questions: - - content: "Question1" + - content: " What’s the single command for executing and compiling Go apps?" choices: - - content: "Answer1" - isCorrect: false + - content: "go build" + isCorrect: true explanation: "Explanation1" - - content: "Answer2" + - content: "go run" isCorrect: false explanation: "Explanation2" - - content: "Answer3" + - content: "go install" isCorrect: false explanation: "Explanation3" - - content: "Answer4" - isCorrect: true + - content: "go compile" + isCorrect: false explanation: "Explanation4" - - content: "Question2" + - content: "Where should you place your project files in your workstation?" choices: - - content: "Answer1" + - content: "Anywhere I want" isCorrect: false explanation: "Explanation1" - - content: "Answer2" + - content: "At the root file system" isCorrect: false explanation: "Explanation2" - - content: "Answer3" - isCorrect: false - explanation: "Explanation3" - - content: "Answer4" + - content: "At the workspace directory" isCorrect: true - explanation: "Explanation4" - - content: "Question3" + explanation: "Explanation3" + - content: "Do Go projects share the same workspace?" choices: - - content: "Answer1" - isCorrect: false + - content: "Yes, you need to create all projects in the same workspace directory ($GOPATH)" + isCorrect: true explanation: "Explanation1" - - content: "Answer2" + - content: "No, you can create a different workspace per project" isCorrect: false explanation: "Explanation2" - - content: "Answer3" + - content: "No, you can create a workspace per project as long as you have properly $GOPATH" isCorrect: false explanation: "Explanation3" - content: "Answer4" - isCorrect: true + isCorrect: false explanation: "Explanation4" diff --git a/get-started-with-go/README.md b/get-started-with-go/README.md index f72e974..59d487c 100644 --- a/get-started-with-go/README.md +++ b/get-started-with-go/README.md @@ -3,30 +3,18 @@ Please fill out the below info to help us keep your module organized properly. Module Title: -< TITLE > +Get started with Go Unit Titles: - Introduction -- < TITLE > -- < TITLE > +- What is Go +- Exercise - Install Go +- Exercise - Explore the Go Playground +- Exercise - Install VS Code and the Go Extension +- Exercise - Hello World +- Knowledge check - Summary -## Instructions - -All modules should have this folder structure: - -- top level module folder - - includes - - 0-unitname.md - - 1-unitname.md - - 2-unitname.md - - etc.md - - media - - yourimagefile.png - - 0-unitname.yml - - 1-unitname.yml - - 2-unitname.yml - - index.yml In **each** .yml file, please fill out all commented fields to the best of your ability. If you have any questions, reach out to Shana. diff --git a/get-started-with-go/media/README.md b/get-started-with-go/media/README.md index 940394a..0f4f0bc 100644 --- a/get-started-with-go/media/README.md +++ b/get-started-with-go/media/README.md @@ -1,8 +1,8 @@ # Media folder -All images you include in your markdown should live in this folder and be referenced in the markdown from this folder. +All images you include in your markdown should live in this folder and be referenced in the markdown from this folder. -Please fill out the below information for any images you've added to this folder that you didn't create yourself (e.g. screenshots). +Please fill out the below information for any images you've added to this folder that you didn't create yourself (e.g. screenshots). Screenshots should include the full window (browser, VS Code, terminal) Please ensure no screenshots have any PII (even your own email address) in them. diff --git a/take-your-first-steps-go/README.md b/take-your-first-steps-go/README.md index 4fa09f1..ed3c4ab 100644 --- a/take-your-first-steps-go/README.md +++ b/take-your-first-steps-go/README.md @@ -3,7 +3,8 @@ Learning Path Title: Take your first steps with Go -Module Titles: +Module Titles: + - Get started with Go - Understand how to use variables, functions, and packages - Use data types and structs, Arrays, Slices, and Maps @@ -12,9 +13,3 @@ Module Titles: - Use methods and interfaces - Learn how concurrency works in Go - Write and test a program - -## Instructions - -Learning paths are defined by a single yaml file. Please fill out all commented fields in the example yaml file in this folder. - -For each new module in your learning path, copy the module folder and do all content development there. Modules & their content do NOT live inside a learning path folder. diff --git a/take-your-first-steps-go/index.yml b/take-your-first-steps-go/index.yml index 5ed726d..bcf9555 100644 --- a/take-your-first-steps-go/index.yml +++ b/take-your-first-steps-go/index.yml @@ -3,22 +3,23 @@ # Fill out all fields with comments uid: metadata: - title: # Add your desired learning path title. All titles must be sentence-case. + title: Take your first steps with Go description: # Add a short description of your learning path for search engines. brand: ms.date: - author: # Your GitHub username (or whomever you'd like to give author attribution to) - ms.author: shanama # Leave this as shanama unless you want content bugs assigned directly to you + author: meaghanlewis + ms.author: shanama ms.topic: interactive-tutorial ms.prod: learning-azure -title: # Your desired learning path title. Same as above. +title: Take your first steps with Go summary: | # Add a description for your learning path to be displayed to users in the given form. Can include the description from above. In this learning path you will: - - - - - - + - Install and configure Go in your local workstation + - Install and configure VS Code and the Go extension + - Explore the Go Playground + - Create your first Go application prerequisites: | # Fill in a detailed list of prerequisites in this form # - prereq 1 @@ -27,7 +28,7 @@ iconUrl: /learn/achievements/generic-trophy.svg # TODO change levels: - beginner roles: -# - Add relevant user role(s) (developer, data scientist, etc.) +- developer - student products: -