CS Writing Style - Generic
This page contains some general rules on good writing style in CS courses.
General Rules
- Proofreading: you should proofread your work to check for spelling, typos, etc. You should also reorganize as seems appropriate while you proofread: your first draft may be a complete solution, but when reading through it you may see a clearer or more direct way to organize your work.
- Be concise: be as concise as possible while still giving as much detail as the instructor wants. A general rule is to include a little more detail than the instructor does for in-class examples. An instructor might choose to return your assignment without reading it if it is too long. Being concise is valued in computer science (and in math and the sciences in general).
- Write for the intended audience: you should generally assume your intended audience is a CS student who has been in the lectures for your course but has not completed the assignment themself. In particular, this means you need to justify your answers and your work and explain it well.
- Complete sentences: for essays, short answer questions, and proofs you should write in complete sentences using good grammar.
- Show your work: as mentioned above, you should include as much detail as the instructor does in class. Note that you are being graded on your understanding, not just for finding the correct answer. So you need to be convincing the instructor that you know how to do this problem.
- Plagiarism: see CS course Policies and additional details in Jeff Kinne Course Policies.
- Handwriting: if turning in something that is hand written, your handwriting needs to be legible. If you turn in something that is not legible, it may be given a grade of 0.
- Page/problem order: turn in your work with the problems in the order they were assigned (e.g. 1, 2, 3) to make it easier for the instructor to find your answers to each problem. If scanning in work, make sure the pages are rotated properly in the file.
