https://dtolnay.github.io/rust-quiz

If you enjoy the Rust Quiz and also know C++, you may like to check out http://cppquiz.org which inspired this project.

I welcome suggestions for new quiz questions, either by filing a GitHub issue in this repository or by sending a pull request containing your question, hint, answer, and explanation of the answer.

The best questions are drawn from personal experience writing or reading Rust code and being bewildered by its behavior.

Aim for no more than 25 lines including blank lines, but shorter than that is better. Questions up to 35 lines may be accepted if there is no possible way to frame the same idea more concisely. Aim for no wider than 40 columns. The only exceptions on width will be for obvious boilerplate that is not necessary to read for solving the question.

The website shows choices for "undefined behavior" and "does not compile", but please prefer adding questions that do compile and are well-defined.

• Not fun: "does this program compile or does it not compile?"
• Not fun: "is this undefined behavior or is it not?"
• Fun: "does this print obvious possibility A or obvious possibility B?"

To add a question, you need to add one .rs file and one .md file under the questions/ directory. Pick a very brief (2-4 words) description to include in the file names. Please use 000 as the question number to avoid races between concurrent pull requests. I will assign a number when merging.

Refer to an existing .md file and copy the format. In particular, you will need to provide a correct answer on the first line, a difficulty rating (1, 2 or 3) on the second line, a Hint section, and an Explanation section.

The difficulty rating should primarily reflect how obscure is the knowledge required to confidently solve the question.

When writing a hint, keep it brief. Maximum three lines, maximum two sentences is ideal.

In the explanation, feel free to be as thorough as possible without dwelling on concepts that are not relevant to the crux of the quiz question.

To launch the site locally and preview your rendered Markdown, run the following inside this directory.

# Package all the questions into a single JavaScript file
# and serve website over http at localhost:8000.
cargo run -- serve

Then your question, assuming you numbered it 000, will be accessible at http://localhost:8000/rust-quiz/0.

The quiz questions, explanations, website, and all other intellectual property in this repository are all licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.