This project intends to help primarily Racket beginners and intermediate users understand Racket concepts and interactions between them.
-
Give definitions of terms used in Racket and Scheme in general.
-
Help beginning and intermediate users understand terms encountered in the Racket documentation. Assume that readers are familiar with imperative programming, but not with functional programming, Scheme and Racket. Therefore, some entries may contain comparisons with related features in other programming languages.
-
Provide context. Most entries have more content than you'd usually expect from a glossary.
You can see the current state of the glossary on the Racket package server.
At the moment, the completion state (generated with the glossary-stats.rkt script) is:
Completion stats, ignoring cross references:
basic |■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■·············| 41 of 55 (75 %) done
intermediate |■■■■■■■···········································| 5 of 34 (15 %) done
advanced |··················································| 0 of 25 ( 0 %) done
total |■■■■■■■■■■■■■■■■■■■■······························| 46 of 114 (40 %) done
I'll surely need some feedback, especially on the intermediate and advanced entries. There are several contribution channels:
- Send feedback to the mailing list (no list subscription necessary).
If you want to send commits, you can:
-
Send diffs (for example, created with
git diff) to the mailing list (see above). -
Send a URL for a public repository of yours to the mailing list (see above). I'll pull from there and contact you with feedback, if necessary.
-
Enter a pull request on Github.
I recommend that you, at least for now, make contributions to the glossary-notes.md file. See the beginning of that file for information on what to add there.
Although not strictly necessary, I'd appreciate it if you wrote commit messages according to these rules.
See the file LICENSE.
