Create stub files for all exercises

kytrinyx commented 5 years ago

We have decided to require all file-based tracks to provide stubs for their exercises.

The lack of stub file generates an unnecessary pain point within Exercism, contributing a significant proportion of support requests, making things more complex for our students, and hindering our ability to automatically run test-suites and provide automated analysis of solutions.

We believe that it’s essential to understand error messages, know how to use an IDE, and create files. However, getting this right as you’re just getting used to a language can be a frustrating distraction, as it can often require a lot of knowledge that tends to seep in over time. At the start, it can be challenging to google for all of these details: what file extension to use, what needs to be included, etc. Getting people up to speed with these things are not Exercism’s focus, and we’ve decided that we are better served by removing this source of confusion, letting people get on with actually solving the exercises.

The original discussion for this is at https://github.com/exercism/discussions/issues/238.

Therefore, we’d like this track to provide a stub file for each exercise.

If this track already provides stub files for all exercises, please close this issue.
If this track already has an open issue for creating stubs, then my apologies. Please close one as a duplicate.
Otherwise, please respond to this issue with useful details about what needs to be done to complete this task in this track so that people who are not familiar with the track may easily contribute.

ricemery commented 5 years ago

@kytrinyx - question - what belongs in the stubs? Is it enough to just have an empty file for the more difficult exercises? Or, are the stubs supposed to contain the class and function signatures??

Thanks

kytrinyx commented 5 years ago

The stubs almost certainly shouldn't have function signatures. For some languages an empty file is probably enough; if there are any require or import or include statements that are necessary that wouldn't be obvious to someone unfamiliar to the language, that would be a good thing to have in there.

ricemery commented 5 years ago

checklist of exercises to update

[x] accumulate
[ ] acronym
[ ] all-your-base
[ ] allergies
[ ] alphametics
[ ] anagram
[ ] armstrong-numbers
[ ] atbash-cipher
[ ] bank-account
[ ] beer-song
[ ] binary
[ ] binary-search
[ ] binary-search-tree
[x] bob
[ ] book-store
[ ] bowling
[ ] bracket-push
[ ] change
[ ] clock
[ ] collatz-conjecture
[ ] complex-numbers
[ ] connect
[ ] crypto-square
[ ] custom-set
[ ] diamond
[ ] difference-of-squares
[ ] dominoes
[x] etl
[ ] flatten-array
[ ] food-chain
[ ] forth
[ ] gigasecond
[x] grade-school
[ ] grains
[x] hamming
[x] hello-world
[ ] hexadecimal
[ ] house
[ ] isogram
[ ] kindergarten-garden
[ ] largest-series-product
[x] leap
[ ] lens-person
[ ] linked-list
[ ] luhn
[ ] matrix
[ ] meetup
[ ] minesweeper
[ ] nth-prime
[ ] nucleotide-count
[ ] ocr-numbers
[ ] octal
[ ] palindrome-products
[ ] pangram
[ ] parallel-letter-frequency
[ ] pascals-triangle
[ ] perfect-numbers
[ ] phone-number
[ ] pig-latin
[ ] prime-factors
[ ] protein-translation
[ ] pythagorean-triplet
[ ] queen-attack
[ ] rail-fence-cipher
[ ] raindrops
[ ] rna-transcription
[ ] robot-name
[x] robot-simulator
[ ] roman-numerals
[ ] rotational-cipher
[ ] run-length-encoding
[ ] saddle-points
[ ] say
[ ] scrabble-score
[ ] secret-handshake
[ ] series
[ ] sgf-parsing
[ ] sieve
[ ] simple-cipher
[ ] simple-linked-list
[x] space-age
[ ] spiral-matrix
[ ] strain
[ ] sublist
[x] sum-of-multiples
[ ] triangle
[ ] trinary
[ ] variable-length-quantity
[ ] word-count
[ ] wordy
[ ] zebra-puzzle
[ ] zipper

exercism / scala

Create stub files for all exercises #617