FAQ


Q:

How do I contact Courselets staff?


A:

We are in the process of finding support staff. If you believe you found a bug, you may file an issue on GitHub at https://github.com/cjlee112/socraticqs2


Q:

I have a question or a complaint, then what?


A:

Please check this FAQ page and see if your question or complaint has been addressed. If not, please contact Courselets staff for help. If the development team needs to make changes to the Courselets platform, a GitHub issue will be filed here: https://github.com/cjlee112/socraticqs2/projects/2. The Courselets platform is still in an early stage of development. There may be bugs to be fixed and things to be improved. We greatly appreciate your engagement as a user on Courselets and your feedback that help us make Courselets better. We will try our best to address your questions and complaints promptly.


Q:

How do I sign up for an account?


A:

Go to https://www.courselets.org. To use your registered account on an external platform (e.g. Google), click the button for that platform. If you want to use an username without linking to an external account, Courselets staff can help you create one.


Q:

What is the difference between a course and a courselet on the Courselets platform?


A:

A course is essentially the same as its original definition - where students enroll to learn a subject matter. A course can have multiple courselets. Each courselet is like a section of the course that focus on one topic or a group of related topics. For example, "Microbiology" is a course, and it can have courselets like "Virus" and "Bacteria", etc.


Q:

How can I create a course?


A:

Currently there is no option for users to create a course, but Courselets staff can help you create one.


Q:

My question or complaint has been filed as an GitHub issue. When will it be resolved?


A:

The issue needs to go through a workflow like this: New -> Open -> In Progress -> In Review -> QA -> Testing -> Verified on Stage (to be included in the upcoming release) -> Deployed on Production (included in the current release) -> Closed. An issue won't have a release date until "Verified on Stage".


Q:

What is the release schedule for the Courselets platform?


A:

Once every two weeks (14 days). You may check planned release dates here: https://github.com/cjlee112/socraticqs2/milestones


Q:

Can I upload images and videos?


A:

Addressed here: https://github.com/cjlee112/socraticqs2/issues/351


Q:

Can I access more statistics on student usage?


A:

Addressed here: https://github.com/cjlee112/socraticqs2/issues/355


Q:

Can I see what specific students see in my Courselet, so I can check if they are progressing okay and/or need help?


A:

Addressed here: https://github.com/cjlee112/socraticqs2/issues/354


Q:

Different types (question, answer, error) of chat boxes look the same, can the system provide a way to differentiate them by color or text labeling?


A:

Addressed here: https://github.com/cjlee112/socraticqs2/issues/347


Q:

Pre-defined error models like "error_concept" are acting funny.


A:

Addressed here: https://github.com/cjlee112/socraticqs2/issues/345


Q:

When I pressed Enter in the chat box, it created a line break, but it then becomes a space after I clicked "Send". Why is that?


A:

The content typed into the chat box is handled as Markdown language, where one line break is displayed as a space, while two line breaks as one line break. Here is the relevant GitHub issue: https://github.com/cjlee112/socraticqs2/issues/342


Q:

Can I export student records on Courselets?


A:

Go to the course, click "Edit" (or go to URL "https://www.courselets.org/ct/teach/courses/XX/edit/", replace "XX" with the course number), scroll down to the bottom of the page, under "Reports", click the "Generate" button, refresh the page, click the "Download" link to download the generated report in JSON format. Here is the relevant GitHub issue: https://github.com/cjlee112/socraticqs2/issues/416.


Q:

Why do some lessons have the "Url" field for editing while some don't?


A:

Look at their own URLs. If it contains "lessons", it should have a "Url" field for editing; otherwise if it contains "concepts", it won't have a "Url" field for editing. More details can be found here: https://github.com/cjlee112/socraticqs2/issues/383


Q:

When logging in as an instructor, I'm getting errors like these when I try to download the course data:

"SyntaxError: JSON.parse: unterminated string at line 1 column 2 of the JSON data"

"SyntaxError: JSON.parse: end of data while reading object contents at line 3 column 4 of the JSON data"


A:

This may be caused by network error. Please try a few more times and see if the error is exactly reproducible. For example,

.

This is NOT exactly reproducible:

You see this at first:

"SyntaxError: JSON.parse: unterminated string at line 5 column 6 of the JSON data"

Then this once you refresh the page:

"SyntaxError: JSON.parse: unterminated string at line 7 column 6 of the JSON data"

.

While this is exactly reproducible:

You see this at first:

"SyntaxError: JSON.parse: unterminated string at line 5 column 6 of the JSON data"

Then this once you refresh the page:

"SyntaxError: JSON.parse: unterminated string at line 5 column 6 of the JSON data"

.

If the error is not exactly reproducible, it may be due to network error. Please check your network connection and fix problems if there are, then try to download again and see if the error no longer occurs.

If the error is exactly reproducible for at least five times, please report it to Courselets staff.