You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
63 lines
2.7 KiB
63 lines
2.7 KiB
3 years ago
|
# Help
|
||
|
|
|
||
|
|
## Running the tests
|
||
|
|
|
||
|
|
Get the first test compiling, linking and passing by following the [three rules of test-driven development][3-tdd-rules].
|
||
|
|
|
||
|
|
The included makefile can be used to create and run the tests using the `test` task.
|
||
|
|
|
||
|
|
```console
|
||
|
|
$ make test
|
||
|
|
```
|
||
|
|
|
||
|
|
Create just the functions you need to satisfy any compiler errors and get the test to fail.
|
||
|
|
Then write just enough code to get the test to pass.
|
||
|
|
Once you've done that, move onto the next test.
|
||
|
|
|
||
|
|
As you progress through the tests, take the time to refactor your implementation for readability and expressiveness and then go on to the next test.
|
||
|
|
|
||
|
|
Try to use standard C99 facilities in preference to writing your own low-level algorithms or facilities by hand.
|
||
|
|
|
||
|
|
[3-tdd-rules]: http://butunclebob.com/ArticleS.UncleBob.TheThreeRulesOfTdd
|
||
|
|
|
||
|
|
## Submitting your solution
|
||
|
|
|
||
|
|
You can submit your solution using the `exercism submit resistor_color.c resistor_color.h` command.
|
||
|
|
This command will upload your solution to the Exercism website and print the solution page's URL.
|
||
|
|
|
||
|
|
It's possible to submit an incomplete solution which allows you to:
|
||
|
|
|
||
|
|
- See how others have completed the exercise
|
||
|
|
- Request help from a mentor
|
||
|
|
|
||
|
|
## Need to get help?
|
||
|
|
|
||
|
|
If you'd like help solving the exercise, check the following pages:
|
||
|
|
|
||
|
|
- The [C track's documentation](https://exercism.org/docs/tracks/c)
|
||
|
|
- [Exercism's support channel on gitter](https://gitter.im/exercism/support)
|
||
|
|
- The [Frequently Asked Questions](https://exercism.org/docs/using/faqs)
|
||
|
|
|
||
|
|
Should those resources not suffice, you could submit your (incomplete) solution to request mentoring.
|
||
|
|
|
||
|
|
Make sure you have read the "Guides" section of the [C track][c-track] on the Exercism site.
|
||
|
|
This covers the basic information on setting up the development environment expected by the exercises.
|
||
|
|
|
||
|
|
## Submitting Incomplete Solutions
|
||
|
|
|
||
|
|
If you are struggling with a particular exercise, it is possible to submit an incomplete solution so you can see how others have completed the exercise.
|
||
|
|
|
||
|
|
## Resources
|
||
|
|
|
||
|
|
To get help if having trouble, you can use the following resources:
|
||
|
|
|
||
|
|
- [StackOverflow][] can be used to search for your problem and see if it has been answered already. You can also ask and answer questions.
|
||
|
|
- [CPPReference][] can be used to look up information on C concepts, operators, types, standard library functions and more.
|
||
|
|
- [TutorialsPoint][] has similar content as CPPReference in its C programming section.
|
||
|
|
- [The C Programming][K&R] book by K&R is the original source of the language and is still useful today.
|
||
|
|
|
||
|
|
[c-track]: https://exercism.io/my/tracks/c
|
||
|
|
[stackoverflow]: http://stackoverflow.com/questions/tagged/c
|
||
|
|
[cppreference]: https://en.cppreference.com/w/c
|
||
|
|
[tutorialspoint]: https://www.tutorialspoint.com/cprogramming/
|
||
|
|
[K&R]: https://www.amazon.com/Programming-Language-2nd-Brian-Kernighan/dp/0131103628/
|