From b78a8dd7913bc6a561f1c2a1772382c1d477afcc Mon Sep 17 00:00:00 2001 From: "Anthony D. Mays" Date: Fri, 1 Nov 2024 02:06:48 +0000 Subject: [PATCH 1/3] docs: add prerequisites clarifying user stories. Signed-off-by: Anthony D. Mays --- project_oop/README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/project_oop/README.md b/project_oop/README.md index eff25d658..1dd4b299b 100644 --- a/project_oop/README.md +++ b/project_oop/README.md @@ -5,6 +5,10 @@ For this project, you and your teammates are tasked with modeling a real-world problem using object-oriented and SOLID design principles, from ideation to implementation. +## Prerequisites + +Before starting work on your project, you will need to submit three user stories as feature requests in your assigned GitHub repo. These will need to be approved by the instructor before you can begin coding. + ## Project Requirements * All work must be submitted in your team's assigned GitHub repository. From 9c3057fddc0d25371be405787b90f88c2545e5d2 Mon Sep 17 00:00:00 2001 From: "Anthony D. Mays" Date: Fri, 1 Nov 2024 02:27:25 +0000 Subject: [PATCH 2/3] docs: minor adjustments Signed-off-by: Anthony D. Mays --- project_oop/README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/project_oop/README.md b/project_oop/README.md index 1dd4b299b..264f53a5a 100644 --- a/project_oop/README.md +++ b/project_oop/README.md @@ -7,24 +7,24 @@ For this project, you and your teammates are tasked with modeling a real-world p ## Prerequisites -Before starting work on your project, you will need to submit three user stories as feature requests in your assigned GitHub repo. These will need to be approved by the instructor before you can begin coding. +Before starting work on your project, you will need to submit three user stories as feature requests in your assigned GitHub repo. These will need to be approved by the instructor before you can begin coding. Your final project submission must enable the functionality described by your user stories. ## Project Requirements * All work must be submitted in your team's assigned GitHub repository. * The assignment can be completed in TypeScript or in Java. -* Must include at least 5 types of objects that relate to each other. -* One of your objects must be a custom data structure that provides for adding, removing, and updating items in a collection +* Must include at least 5 types of objects with meaningful relattionships to each other. +* One of your objects must be a custom data structure that provides for adding, removing, and updating items in a collection. * Implement at least two custom exceptions. -* Write unit tests achieving 90% code coverage -* Must include an integration test -* Your solution must illustrate each of the SOLID principles -* Each team member must contribute at least one commit containing code and tests. -* Include a README for your repo including a description of the problem you're solving, the solution, and how you would improve your solution. +* Write unit tests achieving 90% code coverage. +* Must include an integration test. +* Your solution must illustrate each of the SOLID principles. +* Each team member must contribute *at least one* submitted pull request containing working code and tests. +* Include a README for your repo describing the problem you're solving, the solution, and how you would improve your solution. # Presentation Requirements -* Your total time will be limited to 10 minutes and up to 10 slides. +* Your presentation should be no more than 10 minutes with a maximum of 10 slides. * Each member of the team must speak during the presentation. * Your presentation must address the following questions: * What problem were you attempting to solve? @@ -34,7 +34,7 @@ Before starting work on your project, you will need to submit three user stories ## Extra Credit -Design a CLI that allows users to interact with your application. Check out the code in [lesson_10](/lesson_10/libraries/src/cli/) for an example. +Design a CLI that allows users to interact with your application. Check out the code in [lesson_10](/lesson_10/libraries/src/cli/) for an example in TypeScript, or [this file](/lib/java/codedifferently-instructional/instructional-lib/src/main/java/com/codedifferently/instructional/quiz/QuizProctor.java) for an example in Java. ## Timeline From 5a126388069e1646f908abe17528c54e960e2991 Mon Sep 17 00:00:00 2001 From: "Anthony D. Mays" Date: Fri, 1 Nov 2024 02:47:29 +0000 Subject: [PATCH 3/3] docs: adds note about test coverage Signed-off-by: Anthony D. Mays --- lesson_10/libraries/package.json | 4 ++-- project_oop/README.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/lesson_10/libraries/package.json b/lesson_10/libraries/package.json index 987ad775b..ad974ef51 100644 --- a/lesson_10/libraries/package.json +++ b/lesson_10/libraries/package.json @@ -6,7 +6,7 @@ "scripts": { "start": "node build/lesson10.js", "dev": "tsc-watch --noClear -p ./tsconfig.build.json --onSuccess \"node ./build/lesson10.js\"", - "test": "node --experimental-vm-modules node_modules/.bin/jest", + "test": "node --experimental-vm-modules node_modules/.bin/jest --coverage", "compile": "tsc -p tsconfig.build.json", "prepare": "npm run compile", "pretest": "npm run compile", @@ -42,4 +42,4 @@ "csv-parser": "^3.0.0", "uuid": "^10.0.0" } -} +} \ No newline at end of file diff --git a/project_oop/README.md b/project_oop/README.md index 264f53a5a..55b52438a 100644 --- a/project_oop/README.md +++ b/project_oop/README.md @@ -16,7 +16,7 @@ Before starting work on your project, you will need to submit three user stories * Must include at least 5 types of objects with meaningful relattionships to each other. * One of your objects must be a custom data structure that provides for adding, removing, and updating items in a collection. * Implement at least two custom exceptions. -* Write unit tests achieving 90% code coverage. +* Write unit tests achieving 90% code coverage (using JaCoCo for Java or Jest for Typescript). * Must include an integration test. * Your solution must illustrate each of the SOLID principles. * Each team member must contribute *at least one* submitted pull request containing working code and tests.