Flesh out README a little

This commit is contained in:
Camden Dixie O'Brien 2023-12-14 14:20:11 +00:00
parent fa33a7bdf7
commit 16b92f4c34

View File

@ -1,12 +1,38 @@
# Lua Exercises # Lua Exercises
This repo contains some Lua exercises along with automated tests for This repo contains some Lua exercises along with automated tests for
their solutions. Each file contains a description of the problem and solutions. Each file contains a description of the problem and an
an area for your solution as well as the tests. Feel free to define area for a solution as well as the tests.
as many functions and constants as you need in the solution area, but
do not modify the tests. It's recommended that you roughly stick to ## Set Up
the defined order of the exercises, but feel free to deviate if you
wish. To get started, create a fork of this repo on your own account, then
clone it, passing the `--recursive` flag. If you already cloned it
without passing `--recursive`, you can run `git submodule update
--init` to fix it.
```sh
git clone --recursive git@git.wip.sh:<your-username>/lua-exercises.git
# or
git clone git@git.wip.sh:<your-username>/lua-exercises.git
git submodule update --init
```
## Doing the Exercises
It's recommended that you roughly stick to the defined order of the
exercises, but feel free to deviate if you wish. Some of the
exercises are relatively easy, whereas some of them (especially the
last few) are quite challenging; do not be disheartened if solving a
particular exercise takes you a long time, and feel free to ask for
help in the Discord server if you feel you are stuck.
You can define as many functions and constants as you need in the
solution area. You might find it useful to temporarily comment out
some of the tests to work through the cases one by one (especially on
the more complex exercises), but do not modify the test code other
than this, and make sure all the cases are un-commented again before
considering the exercise solved.
To run the tests and check your solution for a given exercise, simply To run the tests and check your solution for a given exercise, simply
run `lua <the-file>`. For example, if you were working on the run `lua <the-file>`. For example, if you were working on the