From 3e7813c33564f288d92b7c8a59a7240932c7fc80 Mon Sep 17 00:00:00 2001 From: Ben Minifie Date: Thu, 13 Aug 2020 14:51:15 -0400 Subject: [PATCH 1/2] fix: Fixed typos in readme --- .../starter_code/backend/README.md | 42 +++++++++---------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/projects/03_coffee_shop_full_stack/starter_code/backend/README.md b/projects/03_coffee_shop_full_stack/starter_code/backend/README.md index 400ba241d8a..c05ee45f5ce 100755 --- a/projects/03_coffee_shop_full_stack/starter_code/backend/README.md +++ b/projects/03_coffee_shop_full_stack/starter_code/backend/README.md @@ -8,9 +8,9 @@ Follow instructions to install the latest version of python for your platform in the [python docs](https://docs.python.org/3/using/unix.html#getting-and-installing-the-latest-version-of-python) -#### Virtual Enviornment +#### Virtual Environment -We recommend working within a virtual environment whenever using Python for projects. This keeps your dependencies for each project separate and organaized. Instructions for setting up a virual enviornment for your platform can be found in the [python docs](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) +We recommend working within a virtual environment whenever using Python for projects. This keeps your dependencies for each project separate and organized. Instructions for setting up a virtual environment for your platform can be found in the [python docs](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) #### PIP Dependencies @@ -24,7 +24,7 @@ This will install all of the required packages we selected within the `requireme ##### Key Dependencies -- [Flask](http://flask.pocoo.org/) is a lightweight backend microservices framework. Flask is required to handle requests and responses. +- [Flask](http://flask.pocoo.org/) is a lightweight backend microservices framework. Flask is required to handle requests and responses. - [SQLAlchemy](https://www.sqlalchemy.org/) and [Flask-SQLAlchemy](https://flask-sqlalchemy.palletsprojects.com/en/2.x/) are libraries to handle the lightweight sqlite database. Since we want you to focus on auth, we handle the heavy lift for you in `./src/database/models.py`. We recommend skimming this code first so you know how to interface with the Drink model. @@ -56,26 +56,26 @@ The `--reload` flag will detect file changes and restart the server automaticall 2. Select a unique tenant domain 3. Create a new, single page web application 4. Create a new API - - in API Settings: - - Enable RBAC - - Enable Add Permissions in the Access Token + - in API Settings: + - Enable RBAC + - Enable Add Permissions in the Access Token 5. Create new API permissions: - - `get:drinks-detail` - - `post:drinks` - - `patch:drinks` - - `delete:drinks` + - `get:drinks-detail` + - `post:drinks` + - `patch:drinks` + - `delete:drinks` 6. Create new roles for: - - Barista - - can `get:drinks-detail` - - Manager - - can perform all actions -7. Test your endpoints with [Postman](https://getpostman.com). - - Register 2 users - assign the Barista role to one and Manager role to the other. - - Sign into each account and make note of the JWT. - - Import the postman collection `./starter_code/backend/udacity-fsnd-udaspicelatte.postman_collection.json` - - Right-clicking the collection folder for barista and manager, navigate to the authorization tab, and including the JWT in the token field (you should have noted these JWTs). - - Run the collection and correct any errors. - - Export the collection overwriting the one we've included so that we have your proper JWTs during review! + - Barista + - can `get:drinks-detail` + - Manager + - can perform all actions +7. Test your endpoints with [Postman](https://getpostman.com). + - Register 2 users - assign the Barista role to one and Manager role to the other. + - Sign into each account and make note of the JWT. + - Import the postman collection `./starter_code/backend/udacity-fsnd-udaspicelatte.postman_collection.json` + - Right-clicking the collection folder for barista and manager, navigate to the authorization tab, and including the JWT in the token field (you should have noted these JWTs). + - Run the collection and correct any errors. + - Export the collection overwriting the one we've included so that we have your proper JWTs during review! ### Implement The Server From 0fca231e05219637ec874b80999c3d45be91f102 Mon Sep 17 00:00:00 2001 From: Ben Minifie Date: Thu, 13 Aug 2020 15:03:32 -0400 Subject: [PATCH 2/2] fix: Readme typos --- projects/01_fyyur/starter_code/README.md | 2 +- projects/02_trivia_api/starter/README.md | 24 +++++++++---------- .../02_trivia_api/starter/backend/README.md | 6 ++--- .../starter_code/README.md | 12 +++++----- .../starter_code/frontend/README.md | 12 +++++----- 5 files changed, 28 insertions(+), 28 deletions(-) diff --git a/projects/01_fyyur/starter_code/README.md b/projects/01_fyyur/starter_code/README.md index 30364eef74d..f6ea75f47a0 100644 --- a/projects/01_fyyur/starter_code/README.md +++ b/projects/01_fyyur/starter_code/README.md @@ -32,7 +32,7 @@ Our tech stack will include: ```sh ├── README.md ├── app.py *** the main driver of the app. Includes your SQLAlchemy models. - "python app.py" to run after installing dependences + "python app.py" to run after installing dependencies ├── config.py *** Database URLs, CSRF generation, etc ├── error.log ├── forms.py *** Your forms diff --git a/projects/02_trivia_api/starter/README.md b/projects/02_trivia_api/starter/README.md index e9ae1c6bd82..19cb2261d30 100644 --- a/projects/02_trivia_api/starter/README.md +++ b/projects/02_trivia_api/starter/README.md @@ -2,17 +2,17 @@ ## Full Stack Trivia -Udacity is invested in creating bonding experiences for its employees and students. A bunch of team members got the idea to hold trivia on a regular basis and created a webpage to manage the trivia app and play the game, but their API experience is limited and still needs to be built out. +Udacity is invested in creating bonding experiences for its employees and students. A bunch of team members got the idea to hold trivia on a regular basis and created a webpage to manage the trivia app and play the game, but their API experience is limited and still needs to be built out. That's where you come in! Help them finish the trivia app so they can start holding trivia and seeing who's the most knowledgeable of the bunch. The application must: -1) Display questions - both all questions and by category. Questions should show the question, category and difficulty rating by default and can show/hide the answer. -2) Delete questions. -3) Add questions and require that they include question and answer text. -4) Search for questions based on a text query string. -5) Play the quiz game, randomizing either all questions or within a specific category. +1. Display questions - both all questions and by category. Questions should show the question, category and difficulty rating by default and can show/hide the answer. +2. Delete questions. +3. Add questions and require that they include question and answer text. +4. Search for questions based on a text query string. +5. Play the quiz game, randomizing either all questions or within a specific category. -Completing this trivia app will give you the ability to structure plan, implement, and test an API - skills essential for enabling your future applications to communicate with others. +Completing this trivia app will give you the ability to structure plan, implement, and test an API - skills essential for enabling your future applications to communicate with others. ## Tasks @@ -25,20 +25,20 @@ We recommend following the instructions in those files in order. This order will ## Starting and Submitting the Project -[Fork](https://help.github.com/en/articles/fork-a-repo) the [project repository]() and [Clone](https://help.github.com/en/articles/cloning-a-repository) your forked repository to your machine. Work on the project locally and make sure to push all your changes to the remote repository before submitting the link to your repository in the Classroom. +[Fork](https://help.github.com/en/articles/fork-a-repo) the [project repository]() and [Clone](https://help.github.com/en/articles/cloning-a-repository) your forked repository to your machine. Work on the project locally and make sure to push all your changes to the remote repository before submitting the link to your repository in the Classroom. ## About the Stack -We started the full stack application for you. It is desiged with some key functional areas: +We started the full stack application for you. It is designed with some key functional areas: ### Backend -The `./backend` directory contains a partially completed Flask and SQLAlchemy server. You will work primarily in app.py to define your endpoints and can reference models.py for DB and SQLAlchemy setup. +The `./backend` directory contains a partially completed Flask and SQLAlchemy server. You will work primarily in app.py to define your endpoints and can reference models.py for DB and SQLAlchemy setup. ### Frontend -The `./frontend` directory contains a complete React frontend to consume the data from the Flask server. You will need to update the endpoints after you define them in the backend. Those areas are marked with TODO and can be searched for expediency. +The `./frontend` directory contains a complete React frontend to consume the data from the Flask server. You will need to update the endpoints after you define them in the backend. Those areas are marked with TODO and can be searched for expediency. -Pay special attention to what data the frontend is expecting from each API response to help guide how you format your API. +Pay special attention to what data the frontend is expecting from each API response to help guide how you format your API. [View the README.md within ./frontend for more details.](./frontend/README.md) diff --git a/projects/02_trivia_api/starter/backend/README.md b/projects/02_trivia_api/starter/backend/README.md index 6692aed3e18..62b6d49d10b 100644 --- a/projects/02_trivia_api/starter/backend/README.md +++ b/projects/02_trivia_api/starter/backend/README.md @@ -8,13 +8,13 @@ Follow instructions to install the latest version of python for your platform in the [python docs](https://docs.python.org/3/using/unix.html#getting-and-installing-the-latest-version-of-python) -#### Virtual Enviornment +#### Virtual Environment -We recommend working within a virtual environment whenever using Python for projects. This keeps your dependencies for each project separate and organaized. Instructions for setting up a virual enviornment for your platform can be found in the [python docs](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) +We recommend working within a virtual environment whenever using Python for projects. This keeps your dependencies for each project separate and organized. Instructions for setting up a virtual environment for your platform can be found in the [python docs](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) #### PIP Dependencies -Once you have your virtual environment setup and running, install dependencies by naviging to the `/backend` directory and running: +Once you have your virtual environment setup and running, install dependencies by navigating to the `/backend` directory and running: ```bash pip install -r requirements.txt diff --git a/projects/03_coffee_shop_full_stack/starter_code/README.md b/projects/03_coffee_shop_full_stack/starter_code/README.md index 291bb2c7ec9..ee6bd66fd17 100755 --- a/projects/03_coffee_shop_full_stack/starter_code/README.md +++ b/projects/03_coffee_shop_full_stack/starter_code/README.md @@ -6,10 +6,10 @@ Udacity has decided to open a new digitally enabled cafe for students to order d You have been called on to demonstrate your newly learned skills to create a full stack drink menu application. The application must: -1) Display graphics representing the ratios of ingredients in each drink. -2) Allow public users to view drink names and graphics. -3) Allow the shop baristas to see the recipe information. -4) Allow the shop managers to create new drinks and edit existing drinks. +1. Display graphics representing the ratios of ingredients in each drink. +2. Allow public users to view drink names and graphics. +3. Allow the shop baristas to see the recipe information. +4. Allow the shop managers to create new drinks and edit existing drinks. ## Tasks @@ -20,7 +20,7 @@ There are `@TODO` comments throughout the project. We recommend tackling the sec ## About the Stack -We started the full stack application for you. It is desiged with some key functional areas: +We started the full stack application for you. It is designed with some key functional areas: ### Backend @@ -30,6 +30,6 @@ The `./backend` directory contains a partially completed Flask server with a pre ### Frontend -The `./frontend` directory contains a complete Ionic frontend to consume the data from the Flask server. You will only need to update the environment variables found within (./frontend/src/environment/environment.ts) to reflect the Auth0 configuration details set up for the backend app. +The `./frontend` directory contains a complete Ionic frontend to consume the data from the Flask server. You will only need to update the environment variables found within (./frontend/src/environment/environment.ts) to reflect the Auth0 configuration details set up for the backend app. [View the README.md within ./frontend for more details.](./frontend/README.md) diff --git a/projects/03_coffee_shop_full_stack/starter_code/frontend/README.md b/projects/03_coffee_shop_full_stack/starter_code/frontend/README.md index fb21f8d3441..8a1ba51c5e6 100755 --- a/projects/03_coffee_shop_full_stack/starter_code/frontend/README.md +++ b/projects/03_coffee_shop_full_stack/starter_code/frontend/README.md @@ -12,7 +12,7 @@ This project depends on Nodejs and Node Package Manager (NPM). Before continuing #### Installing Ionic Cli -The Ionic Command Line Interface is required to serve and build the frontend. Instructions for installing the CLI is in the [Ionic Framework Docs](https://ionicframework.com/docs/installation/cli). +The Ionic Command Line Interface is required to serve and build the frontend. Instructions for installing the CLI is in the [Ionic Framework Docs](https://ionicframework.com/docs/installation/cli). #### Installing project dependencies @@ -22,11 +22,11 @@ This project uses NPM to manage software dependencies. NPM Relies on the package npm install ``` ->_tip_: **npm i** is shorthand for **npm install** +> _tip_: **npm i** is shorthand for **npm install** ## Required Tasks -### Configure Enviornment Variables +### Configure Environment Variables Ionic uses a configuration file to manage environment variables. These variables ship with the transpiled software and should not include secrets. @@ -40,8 +40,8 @@ Ionic ships with a useful development server which detects changes and transpile ionic serve ``` ->_tip_: Do not use **ionic serve** in production. Instead, build Ionic into a build artifact for your desired platforms. -[Checkout the Ionic docs to learn more](https://ionicframework.com/docs/cli/commands/build) +> _tip_: Do not use **ionic serve** in production. Instead, build Ionic into a build artifact for your desired platforms. +> [Checkout the Ionic docs to learn more](https://ionicframework.com/docs/cli/commands/build) ## Key Software Design Relevant to Our Coursework @@ -53,4 +53,4 @@ The authentication system used for this project is Auth0. `./src/services/auth.s ### Authorization -The Auth0 JWT includes claims for permissions based on the user's role within the Auth0 system. This project makes use of these claims using the `auth.can(permission)` method which checks if particular permissions exist within the JWT permissions claim of the currently logged in user. This method is defined in `./src/services/auth.service.ts` and is then used to enable and disable buttons in `./src/pages/drink-menu/drink-form/drink-form.html`. \ No newline at end of file +The Auth0 JWT includes claims for permissions based on the user's role within the Auth0 system. This project makes use of these claims using the `auth.can(permission)` method which checks if particular permissions exist within the JWT permissions claim of the currently logged in user. This method is defined in `./src/services/auth.service.ts` and is then used to enable and disable buttons in `./src/pages/drink-menu/drink-form/drink-form.html`.