Skip to content

Commit

Permalink
Update calling API mini project based on feedback
Browse files Browse the repository at this point in the history
  • Loading branch information
Zoe Farrell committed Oct 29, 2023
1 parent e38f249 commit 717e2c2
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 2 deletions.
5 changes: 5 additions & 0 deletions module5/lessons/Week4/Swagger.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ Let's start by sharing our responses to the questions from today's prep in two S
* Why would someone use Swagger API Documentation?
* What questions to you have about Swagger?

<aside class="instructor-notes" markdown="1">
<p><strong>Instructor Note</strong><br>
We want students to have the key takeaways that it's easily created documentation for someone new to understand your API endpoints without having to dig into the code. We also want them to understand it's an easy way to test calling the API, similarly to Postman but with less set up. </p>
</aside>

<section class="call-to-action" markdown="1">
With your partner, discuss the following question. Be prepared to share your thoughts when we come back together.

Expand Down
10 changes: 8 additions & 2 deletions module5/projects/CallingAnApiMiniProject.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ title: Calling An API Mini Project

## Overview

For this mini project, imagine that you are working on a team with other developers. One of your teammate is responsible for building an API for keeping track of someone's favorite gifs. Your job is to build a .NET MVC application to call your teammate's API and allow for user interaction.
For this mini project, imagine that you are working on a team with other developers. One of your teammates is responsible for building an API for keeping track of someone's favorite gifs. Your job is to build a .NET MVC application to call your teammate's API and allow for user interaction.

For this project you will be working in pairs and utilizing driver/navigator pair programming.

Expand All @@ -20,14 +20,20 @@ A new tool you'll run into with this project is [Swagger](https://swagger.io/)!

[This](https://github.com/turingschool-examples/GifTracker) is the API repo your teammate is working on. Clone down this repo and checkout the branch `GET-all-gifs`. When you start up the application you should be directed to a Swagger page.

Respond to the checkpoint your instructor will share in Slack when you see the Swagger page.

## The User Experience - Your Job!

The pair of you are responsible for creating a separate application that calls the API to get all gifs, create a gif, update a gif, and delete a gif. How you build the UI for these features is up to you! You're welcome to either use the tools we have covered in class or dive more into javascript.
calls the API endpoints implemented in GifTracker, so that users of your application can: get all gifs, create a gif...

The pair of you are responsible for creating a separate application that calls the API endpoints implemented in GifTracker, so that the users of your application can: get all gifs, create a gif, update a gif, and delete a gif. Your application should not be directly interacting with a database. How you build the UI for these features is up to you! You're welcome to either use the tools we have covered in class or dive more into javascript.

You will be working in four iterations, it's recommended that you start by sketching a mockup of the UI for each phase before moving on to implementation.

As is best practice, check out a new branch for each iteration. Once you have completed the iteration, make a PR and merge your changes in to main.

Because we are simulating working with a teammate, after you finish each iteration you will check out a new branch of the API to simulate your teammate making additional changes.

✅ Once you've created your repo, one partner should send a link to all instructors. After each iteration, send a link to your PR to all instructors so they can follow your progress.

### Iteration 1 - Get all Gifs
Expand Down

0 comments on commit 717e2c2

Please sign in to comment.