diff --git a/README.md b/README.md index fd0979f..532f08a 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,7 @@ Build an App without Using any Code with Microsoft Power Platform | Haimantika M Build an AI web app by using Python and Flask | Christopher Harrison | 1 hour | [Build an AI web app by using Python and Flask](./flask-text-translator/README.md) | How to use Azure Cognitive Services for text translation in a web app build with Python using Flask as a framework | Azure Cognitive Services, Python, Flask | Generate Text with TensorFlow and Keras | Alfredo Deza | 1 hour | [Use TensorFlow and Keras for NLP tasks](./nlp-tensorflow/README.md) | How to process text to generate new text using TensorFlow and Keras running in Jupyter Notebooks | NLP, TensorFlow, Keras, Python, Jupyter | 🏎 Introduction to GitHub with GitHub.dev | [Jen Looper](https://jenlooper.com) | 20 minutes | [Introduction to GitHub with GitHub.dev](./learn-github/README.md) | How to use GitHub.dev to manage common tasks in GitHub | GitHub.dev, GitHub | +🏎 Explore RESTful APIs | [Jen Looper](https://jenlooper.com) | 20 minutes | [Explore the art world by using RESTful APIs](./rest-apis/README.md) | How to query APIs using various authentication strategies | A modern browser | --- ## Slides and courses on how to teach and mentor effectively diff --git a/SECURITY.md b/SECURITY.md index f7b8998..9842a84 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -4,7 +4,7 @@ Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/). -If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)), please report it to us as described below. +If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/previous-versions/tn-archive/cc751383(v=technet.10)), please report it to us as described below. ## Reporting Security Issues @@ -12,7 +12,7 @@ If you believe you have found a security vulnerability in any Microsoft-owned re Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report). -If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc). +If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com). If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/msrc/pgp-key-msrc). You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). @@ -36,6 +36,6 @@ We prefer all communications to be in English. ## Policy -Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/en-us/msrc/cvd). +Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/msrc/cvd). \ No newline at end of file diff --git a/build-canvas-apps/README.md b/build-canvas-apps/README.md index c5bbcd5..12004e4 100644 --- a/build-canvas-apps/README.md +++ b/build-canvas-apps/README.md @@ -11,7 +11,7 @@ In this workshop, we will discuss how to build a no-code app the low-code way wi | **Goal** | Description | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | **What will you learn** | How to build and customize an app with Power Apps and learn about all its elements| -| **What you'll need** | [M365 subscription](https://developer.microsoft.com/en-us/microsoft-365/dev-program) | +| **What you'll need** | [M365 subscription](https://developer.microsoft.com/microsoft-365/dev-program) | | **Duration** | 1 hour | | **Slides** | [Powerpoint](./slides.pptx) | @@ -40,7 +40,7 @@ Do you want to build an app, but the amount of development knowledge required to Ensuring that you have an M365 subscription, visit [Power Apps studio](https://make.powerapps.com) and sign in with your account. -If not, [configure and setup an environment](https://docs.microsoft.com/en-us/power-platform/admin/create-environment). +If not, [configure and setup an environment](https://docs.microsoft.com/power-platform/admin/create-environment). ### Create the app @@ -56,7 +56,7 @@ To add more detail to the app, explore the various [elements](https://docs.micro ### Add logic -Add logic to the app using [functions](https://docs.microsoft.com/en-us/learn/modules/build-app-solution/4-get-started-functions-power-apps). +Add logic to the app using [functions](https://docs.microsoft.com/learn/modules/build-app-solution/4-get-started-functions-power-apps). ### Share your app diff --git a/covid-paper-exploration-workshop/README.md b/covid-paper-exploration-workshop/README.md index d2d6be1..8a00527 100644 --- a/covid-paper-exploration-workshop/README.md +++ b/covid-paper-exploration-workshop/README.md @@ -187,13 +187,13 @@ If you want to learn more: Knowledge extraction that we have performed in this workshop was possible thanks for Text Analytics for Health service, which did most of the job for us. For different knowledge domains, you would need to train your own NER neural network model, and for that you will also need a dataset. The [Custom Named Entity Recognition](https://docs.microsoft.com/azure/cognitive-services/language-service/custom-named-entity-recognition/overview/?WT.mc_id=academic-49822-dmitryso) service can help you do that. -However, the [Text Analytics Service](https://azure.microsoft.com/en-us/services/cognitive-services/text-analytics/?WT.mc_id=academic-49822-dmitryso) has some pre-built [entity extraction mechanism](https://docs.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories/?WT.mc_id=academic-49822-dmitryso), as well as keyword extraction. As an additional challenge, experiment with text from a different problem domain, and see if you can extract some meaningful insights from them. +However, the [Text Analytics Service](https://azure.microsoft.com/services/cognitive-services/text-analytics/?WT.mc_id=academic-49822-dmitryso) has some pre-built [entity extraction mechanism](https://docs.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories/?WT.mc_id=academic-49822-dmitryso), as well as keyword extraction. As an additional challenge, experiment with text from a different problem domain, and see if you can extract some meaningful insights from them. Things you can build: * Analyze a blog or social network posts and get the idea of different topics that author is writing about. See how interests change over time, as well as the mood. You can use the blog of [Scott Hanselman](https://www.hanselman.com/) that goes back to [2002](https://www.hanselman.com/blog/archive/2002). * Analyze [COVID 19 twitter feed](https://github.com/thepanacealab/covid19_twitter) to see if you can extract changes in major topics on twitter. -* Analyze your e-mail archive to see how the topics you discuss and your mood change over time. Most e-mail clients allow you to export your e-mails to plain text or CSV format (here is an [example for Outloook](https://support.microsoft.com/en-us/office/import-and-export-outlook-email-contacts-and-calendar-92577192-3881-4502-b79d-c3bbada6c8ef/?WT.mc_id=academic-49822-dmitryso)). +* Analyze your e-mail archive to see how the topics you discuss and your mood change over time. Most e-mail clients allow you to export your e-mails to plain text or CSV format (here is an [example for Outloook](https://support.microsoft.com/office/import-and-export-outlook-email-contacts-and-calendar-92577192-3881-4502-b79d-c3bbada6c8ef/?WT.mc_id=academic-49822-dmitryso)). ## Feedback diff --git a/learn-github/README.md b/learn-github/README.md index ebfb9cf..5ef3f66 100644 --- a/learn-github/README.md +++ b/learn-github/README.md @@ -6,7 +6,7 @@ ## Goals -In this workshop, we will discuss how to use GitHub.dev to manage basic tasks on GitHub. +In this workshop, you will learn how to use GitHub.dev to manage basic tasks on GitHub. | **Goal** | Description | | ----------------------------- | --------------------------------------------------------------------- | diff --git a/rest-apis/README.md b/rest-apis/README.md new file mode 100644 index 0000000..02a421b --- /dev/null +++ b/rest-apis/README.md @@ -0,0 +1,69 @@ +# Explore the art world by using RESTful APIs + +## Module Source + +[Explore the art world by using RESTful APIs](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/?WT.mc_id=academic-56423-jelooper) + +## Goals + +In this workshop, you will learn the basics of REST APIs, a way to securely query a datasource from an external source. Using Museum APIs, you will discover interesting art via API queries. + +| **Goal** | Description | +| ----------------------------- | --------------------------------------------------------------------- | +| **What will you learn** | Explore the art world by using RESTful APIs | +| **What you'll need** | A modern web browser and an internet connection | +| **Duration** | 20 minutes | +| **Slides** | [slides](./slides.pptx) | + +## Video + +coming soon! + +## What you will learn + +You're a web developer with a passion for the art world. You'd love to create a web page to showcase examples of art through the ages. But you're not sure about the best way to get images of art for your web page. That's where APIs come in! In this module, you'll learn the basics of APIs that help you get images of artwork made public by museums around the world. + +In this workshop, you'll learn about: + +- RESTful APIs +- Strategies to connect to an external API +- Two different museum APIs and how to connect to them using authentication + +## Introduction to RESTful APIs + +Read about RESTful APIs [in this introduction](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/2-what-is-api/?WT.mc_id=academic-56423-jelooper). + +## Query the Metropolitan Museum API + +A great API to query to discover the shape of its data structures as well as its collections is the Metropolitan Museum API from New York. [Let's query it](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/4-query-met-api?/?WT.mc_id=academic-56423-jelooper)! + +## Learn about Authentication Strategies + +While some APIs are open and don't require authentication, many do. Learn more about authentication strategies [in this introduction](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/5-authentication-strategies?WT.mc_id=academic-56423-jelooper). + +## Query the Cooper Hewitt API + +Now that you know how to get an authentication key, practice by [querying another museum api](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/6-query-cooper-hewitt-api/?WT.mc_id=academic-56423-jelooper), the Cooper Hewitt Museum of Art. + +## Handle responses + +[Handle API responses](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/7-handle-responses?WT.mc_id=academic-56423-jelooper) by understanding status codes and what they indicate. + +## Test your knowledge! + +[Take a quiz](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/9-knowledge-check/?WT.mc_id=academic-56423-jelooper)! + +## Next steps + +Explore more about ways to build and use APIs by completing [the other elements](https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art/?WT.mc_id=academic-56423-jelooper) of this module. + +## Optional Transfer Knowledge activity + +Now that you know about APIs and how interesting they can be to discover art, look for other interesting APIs throughout the internet. A good place to start is Todd Motto's [API list](https://github.com/public-apis/public-apis). + +## Feedback + +Be sure to give [feedback about this workshop](https://forms.office.com/r/MdhJWMZthR)! + +[Code of Conduct](CODE_OF_CONDUCT.md) + diff --git a/rest-apis/slides.pptx b/rest-apis/slides.pptx new file mode 100644 index 0000000..686879c Binary files /dev/null and b/rest-apis/slides.pptx differ diff --git a/rest-apis/workshop-designer.md b/rest-apis/workshop-designer.md new file mode 100644 index 0000000..0b002bb --- /dev/null +++ b/rest-apis/workshop-designer.md @@ -0,0 +1,21 @@ + +## Explore the art world by using RESTful APIs + +## Workshop Source + +https://docs.microsoft.com/learn/modules/use-apis-discover-museum-art + +## Stage 1: Desired Results + +1. Students will discover various strategies to query APIs by practicing using Museum APIs. + +## Stage 2: Evidence + +By the end of the workshop, students will be able to query the APIs that require various strategies to authenticate. A quiz is included in the slides and lesson plan. + +## Stage 3: Learning Plan + +- Learn about RESTful APIs +- Query an open, public API +- Query an API that requires authentication +