-
Notifications
You must be signed in to change notification settings - Fork 6
/
README.template
53 lines (35 loc) · 1.85 KB
/
README.template
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
## Project Number/Title
* Author: Your Name
* Class: CS452/CS552 [Operating Systems] Section #num
## Overview
Concisely explain what the program does. If this exceeds a couple of
sentences, you're going too far. Generally you should be pulling this
right from the project specification. We don't want you to just cut and
paste, but paraphrase what is stated in the project specification.
## Manifest
A listing of source files and other non-generated files and a brief (one line)
explanation of the purpose of each file.
## Building the project
This section should tell the user how to build your code. If you are
delivering a library, where does it need to be installed or how do you use
it? Is this an executable, if so how can a user get up to speed as fast
as possible.
## Features and usage
Summarize the main features of your program. It is also appropriate to
instruct the user how to use your program.
## Testing
This section should detail how you tested your code. Simply stating "I ran
it a few times and it seems to work" is not sufficient. Your testing needs to
be detailed here.
## Known Bugs
List known bugs that you weren't able to fix (or ran out of time to fix).
## Reflection and Self Assessment
Discuss the issues you encountered during development and testing. What
problems did you have? What did you have to research and learn on your
own? What kinds of errors did you get? How did you fix them?
What parts of the project did you find challenging? Is there anything that
finally "clicked" for you in the process of working on this project? How well
did the development and testing process go for you?
## Sources Used
If you used any sources outside of the text book you should list them here. If you looked something up on
stackoverflow.com and fail to cite it in this section it will be considered plagiarism and be dealt with accordingly. So be safe CITE!