30
\$\begingroup\$

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

\$\endgroup\$
1
  • 4
    \$\begingroup\$ This post should be displayed as "Featured on meta" alongside the Sandbox. \$\endgroup\$
    – Stevoisiak
    Commented Jul 7, 2017 at 14:53

1 Answer 1

39
\$\begingroup\$

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

...
\$\endgroup\$
1
  • 9
    \$\begingroup\$ If your challenge is just mapping values to new values in some way, your test cases should probably be in the format 1 -> 5, 2 -> 8, 10 -> 240, etc. \$\endgroup\$
    – FlipTack
    Commented Dec 20, 2016 at 21:46

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .