Skip to content

Commit e03b1e4

Browse files
Merge pull request exercism#694 from exercism/generate-readme
Generate exercise READMEs from templates
2 parents 4457406 + 5671e6b commit e03b1e4

164 files changed

Lines changed: 5616 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# {{ .Spec.Name }}
2+
3+
{{ .Spec.Description -}}
4+
{{- with .Hints }}
5+
{{ . }}
6+
{{ end }}
7+
{{- with .TrackInsert }}
8+
{{ . }}
9+
{{ end }}
10+
{{- with .Spec.Credits -}}
11+
## Source
12+
13+
{{ . }}
14+
{{ end }}
15+
## Submitting Incomplete Solutions
16+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
17+

exercises/accumulate/README.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Accumulate
2+
3+
Implement the `accumulate` operation, which, given a collection and an
4+
operation to perform on each element of the collection, returns a new
5+
collection containing the result of applying that operation to each element of
6+
the input collection.
7+
8+
Given the collection of numbers:
9+
10+
- 1, 2, 3, 4, 5
11+
12+
And the operation:
13+
14+
- square a number (`x => x * x`)
15+
16+
Your code should be able to produce the collection of squares:
17+
18+
- 1, 4, 9, 16, 25
19+
20+
Check out the test suite to see the expected function signature.
21+
22+
## Restrictions
23+
24+
Keep your hands off that collect/map/fmap/whatchamacallit functionality
25+
provided by your standard library!
26+
Solve this one yourself using other basic tools instead.
27+
28+
Lisp specific: it's perfectly fine to use `MAPCAR` or the equivalent,
29+
as this is idiomatic Lisp, not a library function.
30+
31+
32+
To run the tests:
33+
34+
```sh
35+
$ gradle test
36+
```
37+
38+
For more detailed info about the Java track see the [help page](http://exercism.io/languages/java).
39+
40+
41+
## Source
42+
43+
Conversation with James Edward Gray II [https://twitter.com/jeg2](https://twitter.com/jeg2)
44+
45+
## Submitting Incomplete Solutions
46+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
47+
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# {{ .Spec.Name }}
2+
3+
{{ .Spec.Description -}}
4+
{{- with .Hints }}
5+
{{ . }}
6+
{{ end }}
7+
{{- with .TrackInsert }}
8+
{{ . }}
9+
{{ end }}
10+
{{- with .Spec.Credits -}}
11+
## Source
12+
13+
{{ . }}
14+
{{ end }}
15+
## Submitting Incomplete Solutions
16+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
17+

exercises/acronym/README.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# Acronym
2+
3+
Convert a phrase to its acronym.
4+
5+
Techies love their TLA (Three Letter Acronyms)!
6+
7+
Help generate some jargon by writing a program that converts a long name
8+
like Portable Network Graphics to its acronym (PNG).
9+
10+
11+
12+
To run the tests:
13+
14+
```sh
15+
$ gradle test
16+
```
17+
18+
For more detailed info about the Java track see the [help page](http://exercism.io/languages/java).
19+
20+
21+
## Source
22+
23+
Julien Vanier [https://github.com/monkbroc](https://github.com/monkbroc)
24+
25+
## Submitting Incomplete Solutions
26+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
27+
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# {{ .Spec.Name }}
2+
3+
{{ .Spec.Description -}}
4+
{{- with .Hints }}
5+
{{ . }}
6+
{{ end }}
7+
{{- with .TrackInsert }}
8+
{{ . }}
9+
{{ end }}
10+
{{- with .Spec.Credits -}}
11+
## Source
12+
13+
{{ . }}
14+
{{ end }}
15+
## Submitting Incomplete Solutions
16+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
17+

exercises/all-your-base/README.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# All Your Base
2+
3+
Convert a number, represented as a sequence of digits in one base, to any other base.
4+
5+
Implement general base conversion. Given a number in base **a**,
6+
represented as a sequence of digits, convert it to base **b**.
7+
8+
## Note
9+
- Try to implement the conversion yourself.
10+
Do not use something else to perform the conversion for you.
11+
12+
## About [Positional Notation](https://en.wikipedia.org/wiki/Positional_notation)
13+
14+
In positional notation, a number in base **b** can be understood as a linear
15+
combination of powers of **b**.
16+
17+
The number 42, *in base 10*, means:
18+
19+
(4 * 10^1) + (2 * 10^0)
20+
21+
The number 101010, *in base 2*, means:
22+
23+
(1 * 2^5) + (0 * 2^4) + (1 * 2^3) + (0 * 2^2) + (1 * 2^1) + (0 * 2^0)
24+
25+
The number 1120, *in base 3*, means:
26+
27+
(1 * 3^3) + (1 * 3^2) + (2 * 3^1) + (0 * 3^0)
28+
29+
I think you got the idea!
30+
31+
32+
*Yes. Those three numbers above are exactly the same. Congratulations!*
33+
34+
35+
To run the tests:
36+
37+
```sh
38+
$ gradle test
39+
```
40+
41+
For more detailed info about the Java track see the [help page](http://exercism.io/languages/java).
42+
43+
44+
45+
## Submitting Incomplete Solutions
46+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
47+
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# {{ .Spec.Name }}
2+
3+
{{ .Spec.Description -}}
4+
{{- with .Hints }}
5+
{{ . }}
6+
{{ end }}
7+
{{- with .TrackInsert }}
8+
{{ . }}
9+
{{ end }}
10+
{{- with .Spec.Credits -}}
11+
## Source
12+
13+
{{ . }}
14+
{{ end }}
15+
## Submitting Incomplete Solutions
16+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
17+

exercises/allergies/README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Allergies
2+
3+
Given a person's allergy score, determine whether or not they're allergic to a given item, and their full list of allergies.
4+
5+
An allergy test produces a single numeric score which contains the
6+
information about all the allergies the person has (that they were
7+
tested for).
8+
9+
The list of items (and their value) that were tested are:
10+
11+
* eggs (1)
12+
* peanuts (2)
13+
* shellfish (4)
14+
* strawberries (8)
15+
* tomatoes (16)
16+
* chocolate (32)
17+
* pollen (64)
18+
* cats (128)
19+
20+
So if Tom is allergic to peanuts and chocolate, he gets a score of 34.
21+
22+
Now, given just that score of 34, your program should be able to say:
23+
24+
- Whether Tom is allergic to any one of those allergens listed above.
25+
- All the allergens Tom is allergic to.
26+
27+
Note: a given score may include allergens **not** listed above (i.e.
28+
allergens that score 256, 512, 1024, etc.). Your program should
29+
ignore those components of the score. For example, if the allergy
30+
score is 257, your program should only report the eggs (1) allergy.
31+
32+
33+
34+
To run the tests:
35+
36+
```sh
37+
$ gradle test
38+
```
39+
40+
For more detailed info about the Java track see the [help page](http://exercism.io/languages/java).
41+
42+
43+
## Source
44+
45+
Jumpstart Lab Warm-up [http://jumpstartlab.com](http://jumpstartlab.com)
46+
47+
## Submitting Incomplete Solutions
48+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
49+
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# {{ .Spec.Name }}
2+
3+
{{ .Spec.Description -}}
4+
{{- with .Hints }}
5+
{{ . }}
6+
{{ end }}
7+
{{- with .TrackInsert }}
8+
{{ . }}
9+
{{ end }}
10+
{{- with .Spec.Credits -}}
11+
## Source
12+
13+
{{ . }}
14+
{{ end }}
15+
## Submitting Incomplete Solutions
16+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
17+

exercises/anagram/README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Anagram
2+
3+
Given a word and a list of possible anagrams, select the correct sublist.
4+
5+
Given `"listen"` and a list of candidates like `"enlists" "google"
6+
"inlets" "banana"` the program should return a list containing
7+
`"inlets"`.
8+
9+
10+
To run the tests:
11+
12+
```sh
13+
$ gradle test
14+
```
15+
16+
For more detailed info about the Java track see the [help page](http://exercism.io/languages/java).
17+
18+
19+
## Source
20+
21+
Inspired by the Extreme Startup game [https://github.com/rchatley/extreme_startup](https://github.com/rchatley/extreme_startup)
22+
23+
## Submitting Incomplete Solutions
24+
It's possible to submit an incomplete solution so you can see how others have completed the exercise.
25+

0 commit comments

Comments
 (0)