đ Note |
---|
This page is primarily targeted for Augusta University students. |
Congratulations on your new position! This page briefly explain what is expected from you as an Undergraduate Course Assistant (UCA).
The Three Rules
There are three important rules for you:
-
This is a job.
Meaning that you have a contract that you should have read and understood, and that you need to carefully clock in and out to receive the pay you deserve. Briefly reviewing the information listed here, and in particular those slides can help you in making sure that you understand all aspects of your position. Do not forget that you are first and foremost a student, and that your main goal here is to graduate.
-
You are here to help students, not to solve their problems.
Please, review what you should and should not do on this section. It is difficult to strike the right balance when helping a student, but a good rule of thumb is that you should not do anything yourself, just explain and give hints so that they can solve the problem they are facing. You are here to help students understand how to solve a problem, not to solve it for them.
-
Donât hesitate to ask.
Thatâs it. You are not alone to deal with difficult situations (cheating, rude behavior, student abusing your time, etc.), and it is normal if you are sometimes unsure of the best course of action. The instructors are happy to train you and help you solve problems that may arise.
In general, UCAs should prioritize giving clear and concise explanations and hints, as to avoid confusion while also helping them better understand the problem-solving process. This means that when you encounter a problem that you are not able to solve, itâs important to ask a colleague who is available for help and try to understand their approach. This way, the student can receive assistance more quickly and will be less likely to get confused during the troubleshooting process. By emphasizing the importance of understanding and working through the problem, rather than just providing a solution, tutors can help students develop the skills they need to become more independent problem-solvers.
On top of supporting students and helping the instructor, you are also encouraged to work on the improvement of those resources. Your contribution may range from spell-checking to pointing inconsistencies, from clarifying statements to re-organizing exercises. Thanks to git and pull requests, you do not need to worry (too much) about introducing mistakes or blunders: the changes you suggest will always be reviewed by instructors before being merged in our master document. We discuss below how you can edit our resources.
Editing the Resources
You need three things to start editing our resources:
- A github account & an invitation,
- Some working knowledge of markdown,
- Some working knowledge of githubâs interface.
Follow the instructions in our âContributing Guidelinesâ for the first step.
For a quick syntax guide in Markdown, the best resource is this website and its 10 minutes tutorial. We list some best practices, and would appreciate if you could follow them.
For githubâs interface, please refer to the following guide.
![âNavigating repositoriesâ](../../img/uca1.png)
The ârinciples of âomputer ârogramming organization repository page on GitHub contains many ârepositoriesâ:
- The princomp.github.io contains most of the resources that will be used (so it will be where you will navigate to the most),
- The feedback-
<semester>
-YYYY and similarly named repositories contain feedback submitted by students/users.
Under the Code section (next to Issues, Pull Requests, Actions, etc.), you will find various folders containing documents for the website.
![âNavigating foldersâ](../../img/uca1a.png)
Typically, if there is some error or mistake, it will be under
source/lectures
,
in the lecture notes, so that will be where you will navigate to the
most:
![Lecture Notes](../../img/uca2.png)
The way the resources are organized is explained here.
For this example, I just clicked on the âCollections,â then â1dâ.
![âEditing Modeâ](../../img/uca4.png)
On this page, you can see the edit history of that specific document you clicked on. In the corner above the document and below the edit history, there is a pencil icon that will put you into editing mode for that document.
When you click on the pencil icon, you will see the document formatted as markdown with two sections at the top of the document: Edit file and Preview. If you have Edit file selected, then you will see the âcodeâ version of the document whereas if you click on the Preview button, you will see the document in its âfinalâ form, or how the website users should see it, without the âcodeâ. To edit, make sure you have Edit file selected.
![âCommitting Changesâ](../../img/uca5gh2.png)
Once you have made the edits you wanted, you need to âcommitâ them; just like how you may write a paper, you need to submit it to the professor for them to see it. At the top right corner of the page, there is a button that says âCommit changes.â Then, a description box pops up for you to describe what you did so others will know the changes you made. (You do not need to go into every detail; just describe it generally, like âI fixed grammatical issuesâ or âFixed code error.â)
As a UCA, you do not have write
access to the princomp.github.io repository, so submitting a change
will write it to a new branch in your fork
<your github handle>/princomp.github.io
, so you can send a pull
request. Given how Github works, after making the necessary edits, click
the âPropose Changesâ button located at the bottom. On this page and the
next, there will be a âCreate pull requestâ button. Clicking on this
will start a pull request. After you have successfully created a new
branch for your commit and started a pull request, your edits will be
checked by others so as to catch any mistake(s) you may have introduced
before your pull request is merged into the base branch.
![âCommittingâ](../../img/uca_guide6.jpg)