Tutoring

Using SMC for Tutoring

Setting Up

SMC is useful for tutoring in math, science, and information technology. Here is one way to get started:

1. Teacher and student both setup accounts in SMC.
2. The teacher makes a project for tutoring and invites the student to that project under Projects > Settings > Collaborators. Invitation is easier if the teacher knows the email address the student used to login to SMC.
3. If the teacher has a subscription or a course plan, both users benefit if the project is upgraded to member hosting. The student does not need to subscribe for this to work. See Pricing for details on member hosting.
4. Student and teacher can then view and update any document in the project, including SMC worksheets, Jupyter notebooks, data and program files, and terminal sessions. Work can proceed in any file either separately or concurrently.

Hints for Effective Tutoring

• If the student is new to SMC, allow most of the first session for orientation. A warm-up with the equivalent of "Hello World" will save time in the long run.
• Create a project-level chat file, for example "project-talk.sage-chat", for conversations outside the scope of a single file or session. Anytime you are logged into SMC, the notification indicator (the bell icon in project toolbar) will show the number of unread messages, whether or not you have the project with the chat open.
• In SMC worksheets (.sagews files) use in-file chat (the bubble icon at upper right) for discussing that file.
• Both .sage-chat files and .sagews in-file chat support HTML, Markdown, and LaTeX (enclose equations between single dollar signs - "$" - for inline LaTeX and double dollar signs - "$$" - for display).
• Use the Log icon in Files toolbar as a shortcut to finding which files have been used most recently. Clicking on the name of a file in the Log opens that file.
• For users comfortable with the Linux shell, create a separate .term file for each user. Teacher and student can collaborate in the same .term, but there will be times when it's convenient to allow separate command-line work.
• If users have different shell preferences, these can be configured using the rocket icon just left of the terminal name in the terminal toolbar; all users logged into a project have the Linux user ID of the project, but individual .term files can use a custom file to set environment variables and aliases. It's necessary to exit the terminal session and let it restart for .term initialization changes to take effect.
• Sometimes it's helpful to switch modes within an SMC worksheet, say between r and python or sage or md. It can be helpful to the student to point out that there is an indicator of the current cell type at upper right, just under the chat bubble icon.
• Encourage experimentation! You can recover work if something goes wrong using Backups (upper right in the Files viewer). SMC worksheets also have time travel, allowing you to restore to a previous version - see Sage Worksheets for details.