[CSC 415] Comments...

[Andrew J. Pounds]

So -- when I have to explain in a few years to visiting accrediting 
teams why I did not give written tests in this class they are going to 
want proof that you actually learned something.   In such cases I refer 
the teams to the code that you wrote and implemented to demonstrate how 
you applied your knowledge in your programming style, what algorithms 
you used, your use of data structures, and why you did various things.   
These people typically will not have enough patience to sift through 
your code to figure out what you did -- they will look for comments.  
Please make sure, therefore, that these things are mentioned in the 
comments.  EVERYONE is responsible for commenting their code (be it in 
the GOFD or your pendulum) -- so do it.  You have done some amazing 
stuff. Just think about about it -- there has been a lot of 
computational geometry going on, physics, implementations of complex 
data structures, algorithms (I even saw a-star) -- now demonstrate some 
academic prowess and actually explain that so that the external 
reviewers will know that!


Yes.   I will be looking at comments (or lack thereof) when I grade.


Because the comments have been SO lacking in Game of Drones, I will give 
you and extra day to turn in Game of Drones.  The final merge commit 
from Alex will have to come on Wednesday night before midnight.   I will 
still be grading the majority of the functionality of the project based 
on the commits made before class today, but I will wait until tomorrow 
nights commits to grade for comments.

-- 
Andrew J. Pounds, Ph.D.  (pounds_aj at mercer.edu)
Professor of Chemistry and Computer Science
Mercer University,  Macon, GA 31207   (478) 301-5627
http://faculty.mercer.edu/pounds_aj

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://theochem.mercer.edu/pipermail/csc415/attachments/20170502/535782af/attachment.html>