Template For Challenges

Question

What format is generally good for questions? Is there a good template I can use?

Return to FAQ index

Answer 1

You can follow this format:

---

Introduction

Briefly describe the challenge. Provide a short background for your challenge. Briefly answer the following questions for your readers.

• Why is this challenge interesting?
• Did you create the challenge? Give credit and provide links to your sources.

A short paragraph will work just fine here. We do not need a book.

Challenge

Describe your challenge in complete detail. The following must be present in any challenge.

• A complete description of all inputs
• A complete description of all outputs
• A complete description of how input and output are related

Answer the following questions for your readers.

• Are there any corner cases? Is it clear how they should be handled?
• How will the winner of the challenge will be determined?
• Is it clear how all submissions will be scored?

Avoid burying the important details of your challenge in a mound of unimportant details. Be concise. Include what needs to be included.

Example Input and Output

Provide at least one example input and output. Make sure they match your own description of what the input should look like.

Input:

This is an example input

Output:

This is an example output

...

---

Copy and paste the following Markdown

# Introduction

Briefly describe the challenge. Provide a short background for your challenge. Briefly answer the following questions for your readers.

 - Why is this challenge interesting?
 - Did you create the challenge? Give credit and provide links to your sources.

A short paragraph will work just fine here. We do not need a book.

# Challenge

Describe your challenge in complete detail. The following must be present in any challenge.

 - A complete description of all inputs
 - A complete description of all outputs
 - A complete description of how input and output are related

Answer the following questions for your readers.

 - Are there any corner cases? Is it clear how they should be handled?
 - How will the winner of the challenge will be determined? 
 - Is it clear how all submissions will be scored?

Avoid burying the important details of your challenge in a mound of unimportant details. Be concise. Include what needs to be included.

# Example Input and Output

Provide at least one example input and output. Make sure they match your own description of what the input should look like.

Input:

> This is an example input

Output:

> This is an example output

...