-
Notifications
You must be signed in to change notification settings - Fork 2
/
IEEE-29148-2011-SRS Template.tex
331 lines (276 loc) · 15.4 KB
/
IEEE-29148-2011-SRS Template.tex
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
%Copyright 2014 Jean-Philippe Eisenbarth
%This program is free software: you can
%redistribute it and/or modify it under the terms of the GNU General Public
%License as published by the Free Software Foundation, either version 3 of the
%License, or (at your option) any later version.
%This program is distributed in the hope that it will be useful,but WITHOUT ANY
%WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
%PARTICULAR PURPOSE. See the GNU General Public License for more details.
%You should have received a copy of the GNU General Public License along with
%this program. If not, see <http://www.gnu.org/licenses/>.
%Based on the code of Yiannis Lazarides
%http://tex.stackexchange.com/questions/42602/software-requirements-specification-with-latex
%http://tex.stackexchange.com/users/963/yiannis-lazarides
%Also based on the template of Karl E. Wiegers
%http://www.se.rit.edu/~emad/teaching/slides/srs_template_sep14.pdf
%http://karlwiegers.com
\documentclass{scrreprt}
\usepackage[titletoc,title,page]{appendix}
\usepackage[english]{babel}
\usepackage{booktabs}
\usepackage{hyperref}
\usepackage[utf8]{inputenc}
\usepackage{listings}
\usepackage{underscore}
\usepackage[table,xcdraw]{xcolor}
\def\myauthorname{Software Smith}
\def\mykeywords{SRS, ISO/IEC/IEEE 29148:2011}
\def\myorganization{Mirohard, Inc.\\1219 Software Highway, Suite 1987 \\ Islandia, NY, 11749}
\def\mysubject{My Super Cool Software}
\def\mytitle{Software Requirement Specification}
\def\myversion{1.0}
%\title{ }
\hypersetup{
pdftitle={\mytitle}, % title
pdfauthor={\myauthorname}, % author
pdfsubject={\mysubject}, % subject of the document
pdfkeywords={\mykeywords}, % list of keywords
colorlinks=true, % false: boxed links; true: colored links
linkcolor=blue, % color of internal links
citecolor=black, % color of links to bibliography
filecolor=black, % color of file links
urlcolor=purple, % color of external links
linktoc=page % only page is linked
}
\begin{document}
\thispagestyle{empty}
\begin{flushright}
\rule{16cm}{5pt}\vskip 0.8cm
\begin{bfseries}
\LARGE{SOFTWARE REQUIREMENTS SPECIFICATION}\\
\vspace{0.8cm}
for \\
\vspace{0.8cm}
\Huge{\mysubject}\\
\vspace{1.9cm}
\Large{Version \myversion}\\
\end{bfseries}
\vfill
\large Prepared by\\
\vspace{0.25cm}
\LARGE \textbf{\myauthorname}
\vfill
\large \myorganization\\
\vspace{0.5cm}
\today\\
\end{flushright}
\chapter*{Revision History}
\setcounter{page}{1}
\begin{center}
\begin{tabular}{@{} l l p{6.5cm} l @{}}
\toprule
\textbf{Name} & \textbf{Date} & \textbf{Reason for Changes} & \textbf{Version} \\
\midrule
Wuping Xin & 2021-10-21 & Initial draft & 1.0 \\
& & & \\
& & & \\
\bottomrule
\end{tabular}
\end{center}
\tableofcontents
\chapter{Introduction}
\section{Purpose}
$<$Identify the product whose software requirements are specified in this
document, including the revision or release number. Describe the scope of the
product that is covered by this SRS, particularly if this SRS describes only
part of the system or a single subsystem.$>$
\section{Document Conventions}
$<$Describe any standards or typographical conventions that were followed when
writing this SRS, such as fonts or highlighting that have special significance.
For example, state whether priorities for higher-level requirements are assumed
to be inherited by detailed requirements, or whether every requirement statement
is to have its own priority.$>$
\section{Intended Audience and Reading Suggestions}
$<$Describe the different types of reader that the document is intended for,
such as developers, project managers, marketing staff, users, testers, and
documentation writers. Describe what the rest of this SRS contains and how it is
organized. Suggest a sequence for reading the document, beginning with the
overview sections and proceeding through the sections that are most pertinent to
each reader type.$>$
\section{Project Scope}
$<$Provide a short description of the software being specified and its purpose,
including relevant benefits, objectives, and goals. Relate the software to
corporate goals or business strategies. If a separate vision and scope document
is available, refer to it rather than duplicating its contents here.$>$
\section{References}
$<$List any other documents or Web addresses to which this SRS refers. These may
include user interface style guides, contracts, standards, system requirements
specifications, use case documents, or a vision and scope document. Provide
enough information so that the reader could access a copy of each reference,
including title, author, version number, date, and source or location.$>$
\chapter{Overall Description}
\section{Product Perspective}
$<$Describe the context and origin of the product being specified in this SRS.
For example, state whether this product is a follow-on member of a product
family, a replacement for certain existing systems, or a new, self-contained
product. If the SRS defines a component of a larger system, relate the
requirements of the larger system to the functionality of this software and
identify interfaces between the two. A simple diagram that shows the major
components of the overall system, subsystem interconnections, and external
interfaces can be helpful.$>$
\section{Product Functions}
$<$Summarize the major functions the product must perform or must let the user
perform. Details will be provided in Section 3, so only a high level summary
(such as a bullet list) is needed here. Organize the functions to make them
understandable to any reader of the SRS. A picture of the major groups of
related requirements and how they relate, such as a top level data flow diagram
or object class diagram, is often effective.$>$
\section{User Classes and Characteristics}
$<$Identify the various user classes that you anticipate will use this product.
User classes may be differentiated based on frequency of use, subset of product
functions used, technical expertise, security or privilege levels, educational
level, or experience. Describe the pertinent characteristics of each user class.
Certain requirements may pertain only to certain user classes. Distinguish the
most important user classes for this product from those who are less important
to satisfy.$>$
\section{Operating Environment}
$<$Describe the environment in which the software will operate, including the
hardware platform, operating system and versions, and any other software
components or applications with which it must peacefully coexist.$>$
\section{Design and Implementation Constraints}
$<$Describe any items or issues that will limit the options available to the
developers. These might include: corporate or regulatory policies; hardware
limitations (timing requirements, memory requirements); interfaces to other
applications; specific technologies, tools, and databases to be used; parallel
operations; language requirements; communications protocols; security
considerations; design conventions or programming standards (for example, if the
customer’s organization will be responsible for maintaining the delivered
software).$>$
\section{User Documentation}
$<$List the user documentation components (such as user manuals, on-line help,
and tutorials) that will be delivered along with the software. Identify any
known user documentation delivery formats or standards.$>$
\section{Assumptions and Dependencies}
$<$List any assumed factors (as opposed to known facts) that could affect the
requirements stated in the SRS. These could include third-party or commercial
components that you plan to use, issues around the development or operating
environment, or constraints. The project could be affected if these assumptions
are incorrect, are not shared, or change. Also identify any dependencies the
project has on external factors, such as software components that you intend to
reuse from another project, unless they are already documented elsewhere (for
example, in the vision and scope document or the project plan).$>$
\chapter{External Interface Requirements}
\section{User Interfaces}
$<$Describe the logical characteristics of each interface between the software
product and the users. This may include sample screen images, any GUI standards
or product family style guides that are to be followed, screen layout
constraints, standard buttons and functions (e.g., help) that will appear on
every screen, keyboard shortcuts, error message display standards, and so on.
Define the software components for which a user interface is needed. Details of
the user interface design should be documented in a separate user interface
specification.$>$
\section{Hardware Interfaces}
$<$Describe the logical and physical characteristics of each interface between
the software product and the hardware components of the system. This may include
the supported device types, the nature of the data and control interactions
between the software and the hardware, and communication protocols to be
used.$>$
\section{Software Interfaces}
$<$Describe the connections between this product and other specific software
components (name and version), including databases, operating systems, tools,
libraries, and integrated commercial components. Identify the data items or
messages coming into the system and going out and describe the purpose of each.
Describe the services needed and the nature of communications. Refer to
documents that describe detailed application programming interface protocols.
Identify data that will be shared across software components. If the data
sharing mechanism must be implemented in a specific way (for example, use of a
global data area in a multitasking operating system), specify this as an
implementation constraint.$>$
\section{Communications Interfaces}
$<$Describe the requirements associated with any communications functions
required by this product, including e-mail, web browser, network server
communications protocols, electronic forms, and so on. Define any pertinent
message formatting. Identify any communication standards that will be used, such
as FTP or HTTP. Specify any communication security or encryption issues, data
transfer rates, and synchronization mechanisms.$>$
\chapter{System Features}
$<$This template illustrates organizing the functional requirements for the
product by system features, the major services provided by the product. You may
prefer to organize this section by use case, mode of operation, user class,
object class, functional hierarchy, or combinations of these, whatever makes the
most logical sense for your product.$>$
\section{System Feature 1}
$<$Don’t really say “System Feature 1.” State the feature name in just a few
words.$>$
\subsection{Description and Priority}
$<$Provide a short description of the feature and indicate whether it is of
High, Medium, or Low priority. You could also include specific priority
component ratings, such as benefit, penalty, cost, and risk (each rated on a
relative scale from a low of 1 to a high of 9).$>$
\subsection{Stimulus/Response Sequences}
$<$List the sequences of user actions and system responses that stimulate the
behavior defined for this feature. These will correspond to the dialog elements
associated with use cases.$>$
\subsection{Functional Requirements}
$<$Itemize the detailed functional requirements associated with this feature.
These are the software capabilities that must be present in order for the user
to carry out the services provided by the feature, or to execute the use case.
Include how the product should respond to anticipated error conditions or
invalid inputs. Requirements should be concise, complete, unambiguous,
verifiable, and necessary. Use “TBD” as a placeholder to indicate when necessary
information is not yet available.$>$
\section{System Feature 2 (and so on)}
\chapter{Other Nonfunctional Requirements}
\section{Performance Requirements}
$<$If there are performance requirements for the product under various
circumstances, state them here and explain their rationale, to help the
developers understand the intent and make suitable design choices. Specify the
timing relationships for real time systems. Make such requirements as specific
as possible. You may need to state performance requirements for individual
functional requirements or features.$>$
\section{Safety Requirements}
$<$Specify those requirements that are concerned with possible loss, damage, or
harm that could result from the use of the product. Define any safeguards or
actions that must be taken, as well as actions that must be prevented. Refer to
any external policies or regulations that state safety issues that affect the
product’s design or use. Define any safety certifications that must be
satisfied.$>$
\section{Security Requirements}
$<$Specify any requirements regarding security or privacy issues surrounding use
of the product or protection of the data used or created by the product. Define
any user identity authentication requirements. Refer to any external policies or
regulations containing security issues that affect the product. Define any
security or privacy certifications that must be satisfied.$>$
\section{Software Quality Attributes}
$<$Specify any additional quality characteristics for the product that will be
important to either the customers or the developers. Some to consider are:
adaptability, availability, correctness, flexibility, interoperability,
maintainability, portability, reliability, reusability, robustness, testability,
and usability. Write these to be specific, quantitative, and verifiable when
possible. At the least, clarify the relative preferences for various attributes,
such as ease of use over ease of learning.$>$
\section{Business Rules}
$<$List any operating principles about the product, such as which individuals or
roles can perform which functions under specific circumstances. These are not
functional requirements in themselves, but they may imply certain functional
requirements to enforce the rules.$>$
\chapter{Other Requirements}
$<$Define any other requirements not covered elsewhere in the SRS. This might
include database requirements, internationalization requirements, legal
requirements, reuse objectives for the project, and so on. Add any new sections
that are pertinent to the project.$>$
\begin{appendices}
%\renewcommand{\thechapter}{}
%\renewcommand{\autodot}{}
\chapter{Glossary}
$<$Define all the terms necessary to properly interpret the SRS, including
acronyms and abbreviations. You may wish to build a separate glossary that spans
multiple projects or the entire organization, and just include terms specific to
a single project in each SRS.$>$
\chapter{Analysis Models}
$<$Optionally, include any pertinent analysis models, such as data flow diagrams, class diagrams, state-transition diagrams, or entity-relationship diagrams.$>$
\chapter{To Be Determined List}
$<$Collect a numbered list of the TBD (to be determined) references that remain
in the SRS so they can be tracked to closure.$>$
\end{appendices}
\end{document}