On Wednesday, May 17, 2017 at 10:58:59 PM UTC-7, Ben Greenman wrote: > The syntax-parse-example package is a showcase of useful macros written using > syntax-parse. > https://pkgs.racket-lang.org/package/syntax-parse-example > > > > At the moment, the showcase is nearly empty ... but it's easy to contribute! > > > 0. Design a beautiful macro, give it a name e.g. BOB > 1. Run `raco pkg install --clone syntax-parse-example; cd > syntax-parse-example` > 2. Run `raco syntax-parse-example --new BOB`. This generates a directory and > 3 files: > - `BOB/BOB.rkt` : the macro goes here > - `BOB/BOB-test.rkt` : for unit tests > - `BOB/BOB.scrbl` : for documentation > 3. Fill in the blanks in the new files, add `BOB` to the top-level file > `index.scrbl`. > > > > > Then, if you run `raco setup syntax-parse-example` it will render your > documentation on the page for the `syntax-parse-example` module. > > > - - - > > > Example doc: > http://docs.racket-lang.org/syntax-parse-example/index.html?q=syntax-parse-example#%28part._first-class-or%29 > > > > The doc's source: > https://github.com/bennn/syntax-parse-example/blob/master/first-class-or/first-class-or.scrbl
This is really neat, documentation like this can go a long way towards making Racket macros more accessible to everyone. Thank you Ben! -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
