.. (לתיקייה המכילה) | ||
How do I submit the homeworks ? | |
Homework submission is in pairs only! Every home assignment must be submitted both in hard copy (into the course submission box) and electronically (from the page where the homework is published). |
Where can I work on the homeworks ? | |
At Taub PC farm or at home. To work at home you need a computer with DOS and PDP-11 assembler and simulator. It can be downloaded from the "Course Material" section of this site. |
What do you mean by "internal and external documentation"? | |
You are required to submit your code when it contains internal documentation, and add an external documentation to the dry part. Internal documentation is remarks after the important lines (or before and after them) which explain what these lines do, and how. As a guiding rule, if the number of remarks are less than half the number of code lines, you should consider adding remarks (and by adding remarks we don't mean jokes and verses from the bible, but rather remarks that explain the code). External documentation is 1-3 pages that are NOT a part of the code. The external documentation has to start with a description of the task your code is ment to solve (Even if it means writing things we wrote in the assignment ourselves..) It should be readable by someone who hasn't seen your code and doesn't know its intention. It should supply anyone the means of using your routines in different ways than you intended, replacing them with improved code that encapsulates the same functionality without understanding the entire functionality of the program, etc'. It should include description of each routine (what does it do, how does it receive\return parameters, how does it work roughly, and any special things that you think are important), of the data structures that you add to the program and of the data structures that we are going to put there, important labels, recursions if any, etc'. External documentaton should be printed on a diffrent page than your code. If you have specific questions regarding the documentation issue, please ask, so you will know exactly what we expect to get from you. |