exercism/emacs-lisp is one of many programming language tracks you can study on exercism.org. This repo holds all the instructions, tests, code, & support files for Emacs Lisp exercises currently under development or implemented & available for students. If you haven't already, you can check out and study the live language track here.

🌟   The test runner is currently running Emacs 29.4

Currently the Emacs Lisp track doesn't feature a syllabus, so it only contains practice exercises. Practice exercises are open-ended problems that allow you to build and test your knowledge of a programming language. You can find the practice exercises referenced in the config.json and the files in the exercises/practice directory. The practice exercises are shared between tracks. You can find the canonical problem description in the problem specifications repository.

🌟🌟  Please take a moment to read our Code of Conduct 🌟🌟 
It might also be helpful to look at Being a Good Community Member & The words that we use.

                         Some defined roles in our community: Contributors | Mentors | Maintainers | Admins

We 💙 our community and welcome contributions.

The following guide is intended to give you an overview about the different ways to help and to point you to the relevant documentation.

• reporting problems with the track or possible improvements
• working on practice exercises
• working on track tooling and CI
• working on the test runner
• working on track documents
• contributing approaches
• contributing articles

Feel free to open an issue or open a pull request for any of those items. Pull Requests should be focused on a single change. They must pass the CI system and need a review by a maintainer before they can get merged.

You can also start work on

• a syllabus / concept exercises, used to teach a language step by step
• an analyzer, used to give automated feedback on student solutions
• a representer, used to give automated feedback on sutdent solutions

If you want to start work on one of those items please first get in touch via GitHub issues or the discourse forum.

✨ 🦄  Not sure how to do something? Check out the documentation!
     Structure | Tasks | Concepts | Concept Exercises | Practice Exercises | Presentation
     Writing Style Guide | Markdown Specification (markdown guidelines for contributing on exercism.org)

• Emacs Lisp Test Runner - used to test the solutions submitted by students
• Website Copy - contains mentoring notes

This repository uses the MIT License.

The GNU Emacs icon was designed by Andrew Zhilin and is licensed under the Creative Commons Attribution-ShareAlike 3.0 License. We have modified the GNU Emacs icon to create the Emacs Lisp icon for Exercism.