Merge pull request #2 from neu-se/m01-intro-requirements

m01-introduction-requirements

.github/workflows/contvert_pptx-to_pdf.yml

@@ -0,0 +1,41 @@
+name: Convert PPTX to PDF
+
+on:
+  push:
+    paths:
+      - '*.pptx'
+
+jobs:
+  convert:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.9
+
+    - name: Install dependencies
+      run: |
+        pip install pypandoc
+        sudo apt-get install -y libreoffice
+
+    - name: Convert PPTX to PDF
+      run: |
+        for file in $(git diff --name-only HEAD HEAD~1 | grep .pptx); do
+          libreoffice --headless --convert-to pdf "$file"
+        done
+
+    - name: Add PDF to commit
+      run: |
+        git config --global user.name 'github-actions'
+        git config --global user.email '[email protected]'
+        for file in $(git diff --name-only HEAD HEAD~1 | grep .pptx); do
+          pdf_file="${file%.pptx}.pdf"
+          git add "$pdf_file"
+        done
+        git commit -m "Add converted PDF files"
+        git push

.gitignore

@@ -8,6 +8,8 @@ node_modules/
 vendor/
 *~
 .DS_Store
+Gemfile.lock
+
 
 
 

Activities/Module01 Activity.md

@@ -0,0 +1,40 @@
+---
+layout: page
+title: User Stories and Conditions of Satisfaction
+nav_exclude: true
+---
+## Activity 1: User Stories and Conditions of Satisfaction
+
+### Introduction
+
+This activity will give you practice with using user stories to solicit and document user requirements, refining them into conditions of satisfaction, and assigning priorities.
+
+Before you start, be sure to review the tutorial "User Stories and Conditions of Satisfaction" on the course website.
+
+### Scenario
+
+Consider a Learning Management System (like Canvas).  Choose ***one*** of the following areas:
+
+1. Sections and Enrollment
+2. Assignment Submission and Grading
+3. Gradebooks
+
+
+### Requirements for this activity
+
+1. Identify at least 3 different roles representing different classes of users for that area.
+
+2. Choose **one** of those roles and write down at least 3 different user stories for that participant.  These should be of the form
+
+    As a <code>&lt;role&gt;</code> I want <code>&lt;some capability&gt;</code> so that I can <code>&lt;get some benefit&gt;</code>
+
+3. For **each** user story, write 3 conditions of satisfaction with appropriate priorities. (Essential = user story is not satisfied without it)
+
+Please submit a total of:
+
+* 1 area
+* 3 roles
+* 3 user stories
+* 9 conditions of satisfaction with priorities
+
+When you are done, submit your work as required by your instructor (check the Canvas asssignment for details, if assigned). This may vary from section to section.

_data/modules.yml

@@ -3,7 +3,7 @@
 # Each key has a "name" attribute (rendered on the calendar), a "page" attribute (which contains a link to the lesson) and an optional "type" attribute, which is a key into the _data/config.yml "types" dictionary.
 1a:
   name: Orientation & Requirements
-  page: 
+  page: /modules/1-requirements-testing
 1b:
   name: Typescript & Test Driven Development
   page: 

lectures/l1.md

@@ -0,0 +1,41 @@
+---
+layout: module
+title: "1 - Orientation & Requirements"
+permalink: /modules/1-requirements-testing
+parent: Modules
+nav_order: 1
+lessons: 
+  - title: Course Introduction
+    pdf: "Module 01.1 Course Introduction.pdf"
+    ppt: "Module 01.1 Course Introduction.pptx"
+  - title: Requirements Gathering
+    pdf: "Module 01.2 Requirements Gathering.pdf" 
+    ppt: "Module 01.2 Requirements Gathering.pptx"
+---
+### Learning Objectives:
+In this lecture, you will learn
+
+* a little about the scope of Software Engineering and how it differs from programming
+* how this course will be organized, and what will be expected from you each week.
+* two different ways to solicit and document our users' requirements
+
+### Important Dates:
+* Individual Project 1 **Due Wednesday, January 22 by 12pm (Noon)**{: .label .label-red }
+
+{% include lesson.html %}
+
+### Activity
+* [Working with User Stories]({{site.baseurl}}{% link Activities/Module01 Activity.md %})
+
+### Tutorials
+* Installing a Development Environment) 
+* Getting Started with TypeScript
+* User Stories and Conditions of Satisfaction
+* MongoDb tutorial
+* Guide to API Requests and Installing Postman
+
+### Resources
+* [Class Syllabus](https://neu-se.github.io/CS4530-Spring-2025/)
+* [INVEST criteria for user stories](https://agileforall.com/new-to-agile-invest-in-good-user-stories/
+)
+* Project Overview