Report a Bug

Check the FAQ

Sorry you are having trouble. I want to hear about problems you are having but before you create a bug report please Check our FAQ

Get help from the Community

If you have a question that isn't answered in the FAQ there are a number of places to get help from the Runestone Community. Each of our books has a great community of teachers who are willing to help new people get started. Check This List of community resources!

If you are a new instructor there is a very helpful playlist of videos on YouTube. In the summer of 2020 we did a 4 day virtual workshop for 200+ instructors. I can almost guarantee that one of these videos will answer your questions about running a class on Runestone.

File a Report on GitHub

OK, You don't have a question and are still running into some problem. Its time to create an issue on our Github Issue Tracker I regret that I am no longer able to respond to problems sent to me in email. Runestone has just grown too big for that. Filing issues on Github creates a public record that others can learn from and help with. Your own problem may already be on Github, if so, you can add more evidence to the record that will help me (or someone else) get to the bottom of the problem more quickly.

Filing an effective Bug Report

Telling me that X does not work doesn’t really help. The truth is runestone.academy gets over 300,000 page views a day from people around the world. So most of the time when someone says “X does not work” it does in fact work fine for most people. This does not make it your fault, it just means I need more information to try to make sense of what is going on. Here are a few tips

Please note, I'm not trying to be rude, but years of observation have taught me that CS teachers are pretty bad bug reporters! Imagine if a student sent you the following email:

    Hey,
    
    You know problem 2 for the homework next week.  
    My program just doesn't work.  I'm pretty sure 
    I've done everything right.  Can you tell me how 
    to fix it?
    
    Thanks,
    
    Student

You wouldn't be able to help this student very much, in fact you probably wouldn't have any idea what program that student was even asking about without spending your own valuable time figuring it out. Sadly, It is a pretty good representation of thousands of bug reports I've received. So please, take a few seconds and read or re-read Filing an effective bug report. Thanks.