Submission Standards for SYST10199

Standards for All Files in Submissions

All files in all submissions must include programmer ID documentation: multi-line comments/documentation at the top of each source file in the following format:

For INDEX.HTML files:

<!--
Name:  [your name here]
Assignment:  [the name/title of the submission]
Date:  [the due date of the submission]
[a blank line]
App Description: [brief description of application in your own words]
Page Description: [brief description of this page's purpose/role in the application]
Files: [a list (with summary descriptions) of other files that make up this application]
-->

For all other HTML, CSS, and JS files:

The same as above, but without the App Description.

Example: In this example, a submission consists of an application with index.html, calls.php, main.css, and spca.js. Each file should be identified as follows:

index.html:

<!--
Name:  Sydney Greenstreet
Assignment:  In-Class 3
Date:  August 3 2014

App Description: This application allows emergency personnel to communicate with
the main dispatcher at the Hamilton SPCA.  The user can log in and view calls that
haven't been assigned, and they can accept unassigned calls and report on calls that
have been completed.
Page Description: This is the main login page for emergency personnel with the
Hamilton SPCA logo and contact information.  It also contains phone numbers in 
case the user is having technical problems with the web application.
Files: calls.php - the database-driven calls page
       main.css - the main styles for this application
       spca.js - Javascript functions and constants specific to this application
-->

calls.php:

/* 
Name:  Sydney Greenstreet
Assignment:  In-Class 3
Date:  August 3 2014

Page Description: This is the page emergency personnel will see once they've
successfully logged in.  They will be able to see a list of unanswered calls,
select an unanswered call to attend to, and file reports for calls that they
have completed.
Files: index.html - the main login page for emergency personnel
       main.css - the main styles for this application
       spca.js - Javascript functions and constants specific to this application
*/

main.css:

/*
Name:  Sydney Greenstreet
Assignment:  In-Class 3
Date:  August 3 2014

Page Description: This is the main CSS file for this application and defines
all of the styles required for all pages in the app.
Files: index.html - the main login page for emergency personnel
       calls.php - the database-driven calls page
       spca.js - Javascript functions and constants specific to this application
*/

spca.js

/*
Name:  Sydney Greenstreet
Assignment:  In-Class 3
Date:  August 3 2014

Page Description: This contains the constants and functions needed for
this application, including AJAX functions and data validation functions.
It also contains some contants that are used on all pages of the application
such as the company name and contact information. 
Files: index.html - the main login page for emergency personnel
       calls.php - the database-driven calls page
       main.css - the main styles for this application
*/

Additionally, all files included in submissions must meet industry standards and style conventions, as outlined in the Coding Standards for SYST10199 document. This document outlines things like proper indentation, spacing, naming conventions, brace styles, etc.

Standards for Electronic Submissions

In addition to the basic standards mentioned above, make sure you follow these instructions/standards also:

Electronic submission are usually uploaded to a web server or an LMS such as SLATE, or submitted via a memory key or portable hard drive to the professor. Therefore, your prof may have some specific naming conventions or other rules for the types of files you may upload/submit. These will be clearly stated in the assignment. If they are not clearly stated in the assignment, then the policy regarding submitted files is as follows:

• All submissions must be contained within a single ZIP/RAR file.
• Your ZIP/RAR file must be named login_assignmentName.ZIP or login_assignmentName.RAR where "login" is your actual Sheridan login name and "assignmentName" is the actual name of the assignment you are submitting (e.g. Lab1, Assignment2).
• If you are asked to submit source code only, then your ZIP/RAR file should contain only the necessary .java source code files that make up your assignment.
• Students in term 2 and higher are usually asked to submit the entire project (e.g. the entire NetBeans project). This means your ZIP/RAR file needs to include your entire project root directory.
• You will sometimes also be asked to submit a text file or word processed document that contains all of your source code. This is for the Originality Checker in SLATE (it compares all of the submissions of all students at Sheridan over the past few years to make sure your code is original and not copied from another student (or that another student hasn't copied you!)) To create this file, simply open up any text editor or word processor (your professor will let you know which file formats they support) and paste all of your source code into it. This file is uploaded separately from your zip/rar file, not inside it.

Make sure you read your assignment's submission instructions carefully so that you submit the correct files/folders.