Student Beginner Tutorial

Welcome to COMTOR the comment mentor. This tutorial will guide you through account setup to submitting files for analysis. It will then cover other aspects of the COMTOR web app (is this what you call it?), and go into detail on the different modules (to be edited).

Registering an Account:
To begin on the left tool bar click on Create An Account. Next fill out your name, select from the school you are associated and finally the email address that the professor will use to communicate with you. The email address will also serve as your login name. If you are a professor you can click on "Request Professor Status" and submit a link to your school webpage in which you are listed as a professor. A temporary email password will be sent to your email address which you will use to log in the first time. Next, to login, click on the login button on the left tool bar- fill in your email address and the temporary password given to you.

Registering for a Class:
In order to submit code for commenting you need to register for a class. On the left tool bar click on Courses to bring you to the courses that your professor has listed. To register click on Enroll on the right side of the class that you are in.A prompt will ask you to verify that it is your course- click on OK. Now that you are registered for your class you need to select the course in order to access the modules. You can select your class from the pull down menu on the upper right that says Course Select and will have your course listed. Or from the Welcome screen you can select which class you are in.

(This step seems a little out of place, when you click on enroll you aren't actually navigating the class dropbox etc. I understand giving the ability to enroll in multiple classes at this time, but I think it should select the last class you selected or something like that, otherwise the class modules and dropbox aren't displayed. This step was very confusing the first time. Again from the Welcome screen when you select a class you are automatically taken to the dropbox but not from the pull down menu)

Submitting Code:
Once you have registered for a class and selected that class, the Modules menu for that class will be available on the left tool bar. Click on View Course Dropbox. On this screen all of the modules for COMTOR are listed. Click on Submit Code for an Assignment. (Now the modules have a checkbox next to them but don't really do anything. This needs to be removed or modified).

Click on the pull down menu (which isn't labeled) under the header Assignment. Choose to which module you will be submitting your code. The appropriate module will be checked. Code must be submitted as a Java Source Jar file. All .java files must be archived into a jar file. Click on Browse and select the jar file to submit. Finally click on Analyze Comments to view COMTOR's results.

NOTE: COMTOR only checks comments referring to methods, classes, etc. Code within such methods/classes will NOT be graded, or even seen by COMTOR.

Course Management:
To change which class you are enrolled in click on Courses under account management and then select Enroll or Drop under Actions.

You may view an overall summary of the modules submitted for this class under View All Reports.

Change Password:
To change your password, click on Account Management under the Account setup menu. Next click on the Change Password link. Fill in the old password and the new one and click submit.

Disable Account:
To disable your account, click on Account Management under Account Setup. Next click on Disable Account and verify your selection by clicking OK. This is can only be undone by e-mailing an administrator. You cannot re-register under this email.

Email Notifications:
You may request to be notified at the email address provided of various options. Click on E-mail Notifications under Account Setup. You may select the frequency and type of notification at this time.