Requirements Engineering - This week's Highlights

This weeks topic is Software Requirements Analysis or Requirements Engineering. This week we will create a Software Requirements & Design Document (SRD).

We have the following main differences between Requirements and Design:

Requirements (WHAT): WHAT the system should do. Describes what the system should do with Words and Figures, etc. The results is a Software Requirements Specification Document (SRS)
Software Design (HOW): HOW it should do it. Examples: GUI Design, UML, ER diagram, CAD, etc. The results is a Software Design Document (SDD).

Many don't separate SRS and SDD documents, but include everything in a Requirements & Design Document (SRD). In practice, requirements and design are inseparable.

In addition, we will create or update the Project Plan/Gantt Chart based on the Requirements Analysis/Engineering process. Make sure to update the Software Development Plan (SDP) document as well.

We will also start using (or continue) using Azure DevOps (previously known as Visual Studio Team Services, VSTS).

For more details, see the Week Assignment.

1. Preparations

2-3h. Main focus: Prepare to participate in class activities. It is important that you are prepared when you come to class.

Requirements Engineering - This week's Highlights

Software

You need the following Software (make sure to install them before you come to class!):

Office 365 (Word, Excel, PowerPoint, Skype for Business)
MS Project Professional (Project Management, Gantt Chart). Download from Microsoft Azure Dev Tools for Teaching.
Visual Studio We will use Visual Studio as our main Development Tool.
Azure DevOps (previously Visual Studio Team Services) Note! You dont need to install it! You need to create an account and then you can use it within your web browser and inside Visual Studio (it is integrated with Visual Studio). Introduction to Azure DevOps. Here you see the settings for Create New Project.

(You will need more software later)

PC recommendations - The main tool will be your PC, so make sure your PC is up to date.

Note! In class we will need to use the software mentioned above. Installing software is time consuming! Don't waste your, the group or the teachers time in class. Make sure to install it before class. If you don't have the software ready for class, you cannot keep up with the practical exercises and project work that you should do in class.

Resources

Please go through the resources below before you meet in class.

Video: An Introduction to Requirements Engineering:

Video: Introduction to Azure DevOps previously known as Visual Studio Team Services (VSTS):

Azure DevOps (YouTube) + PowerPoint (PDF)

Azure DevOps (previously known as Visual Studio Team Services) will be our main tool in this course, and we will use it throughout the entire project.

Video: Make a System Sketch in PowerPoint:

A System sketch is an illustration/figure of your system, the different parts the system consists of, and how they relate to each other. One of more system sketches are needed in the Software Development Plan (SDP) and Software Requirements and Design (SRD) documents.

Write Technical Reports in Microsoft Word - All documents you write in this course (and in documentation in general) need to have a proper level of quality, including a proper structure, figure numbers and figure captions, figure referencing, references, etc.

Textbooks

The theory part of this course is "reading material" (it's like reading a novel), so be sure to take a look at some of the textbook resources below, and especially the Sommerville book (or Safari books online book if you dont have the Sommerville book). The main concept in this course is to read the theory at home and then apply the theory concepts on the project.

Software Development Literature

Read the following chapters in one ore more of the following Textbooks below before you meet in class:

Textbook	Syllabus
Software Development - A Practical Approach	Ch.8: Project Management Ch.9: Requirements Engineering Ch.10: User eXperience (UX)
Software Engineering (I. Sommerville)	Ch.4 Requirements Engineering Ch.22 Project Management
Essentials of Software Engineering (Frank Tsu et al.)	Ch.6: Requirements Engineering Ch.13: Software Project Management App.B: SRS
Software Engineering (Saikat Dutt, et al.)	Ch.2: Requirements Engineering ... Ch.7: User Interface Design

2. Activities in Class

6h. Main focus: Practice applying key concepts with feedback. Execution and review of the week assignments will be the main focus in the scheduled class activities.

Review: Each Team should give a short overview of their Software Development Plan (SDP). Class discussions and feedback. Make sure to upload the SDP document to Microsoft Teams.

Week Assignment

It is important that you do what's in the weekly assignments. The weekly assignments guides you through the course with a red line with a primary focus on important topics in software engineering and practical implementation of these topics through a large project. The contents of the week assignments are important criteria when it comes to censorship and grading in this course.

Main focus:

The main focus this week will be to create a Software Requirements and Design Document (SRD) - All the requirements and design (both GUI design and architectural design) information needs to be included in this document.

Videos:

The following Videos will be presented and discussed in class:

Software Engineering and Requirements (Espen Eckbo) - Is this how you do Requirements Analysis? Class discussions around this video in class. Flexus.

Azure DevOps (previously known as Visual Studio Team Services)

Short Introduction to Azure DevOps

At this point the following features in Azure DevOps should be known:

Create a Project and Add Members
Link the Project to your local Visual Studio and a local Work Folder
Create a Folder structure for Documents and Code using the Web Site or the Source Control Explorer in Visual Studio (see example in Week Assignment)
Upload Documents
Create Areas and Iterations
Create a list of Requirements (Product Backlog Items) and Tasks
- Product Backlog Items (PBI): Requirements written in SRD document
- Tasks: The necessary Tasks needed to solve a specific Requirement (PBI)
Create a simple ASP.NET Core Web Application and use Source Code Control (Check-in and Check-out Files)

Azure DevOps will be our main tool in this course, and we will use it throughout the entire project. So it is important that you start using it as soon as possible!

Introduction to Azure DevOps

Quiz:

Quiz (Requirements Engineering) - Can you relax this weekend? - or do you need to take an extra look at some of the available resources? In order to Pass this Quiz, you need to get a Score >= 70%. You should answer the questions without any aids!

3. Complementary Work

6-7h. Main focus: Finish Week Assignment. Check your understanding and extend your learning. Go through the following resources in order to review and get a deeper understanding of what you should learn in this topic. You may also need these resources in order to solve the week assignment.

Documents

It is recommended that you read the following documents:

Suksess og fiasko i offentlige IKT- prosjekter

Videos

It is recommended that you watch the following videos:

Video: ASP.NET Core - Hello World:

Video: ASP.NET Core - Introduction:

ASP.NET Core Overview (PowerPoint, PDF)

This video is also available on my Youtube Channel (Industrial IT and Automation).

Click here in order to see more ASP.NET Core Videos and Download Examples.

Web Resources

Below you find some additional resources for deeper understanding and reflection:

Suksess og fiasko i offentlige IKT- prosjekter + Rapport (PDF)

Atle (42) står bak Amazon-skyen

Review

Review Questions (Requirements Engineering) - Note! This is mandatory! In order to Pass this Quiz, you need to get a Score >= 50%.

In order to get best outcome, you should answer the questions without any aids! You should also write your answers in your own words using Norwegian language. Don't just copy the text directly from the PowerPoints or the Textbooks, in that way you dont learn anything! When answering the Questions, pretend you are sit down taking the final written Exam. This means you should watch Videos, read the Textbooks, PowerPoints and oher Resources in advance before you start answering the Review Questions.