RacketCon Hackathon 2012 - racket/racket GitHub Wiki

This is the organization page for the Hackathon at RacketCon 2012.

  • Where: WVH 110
  • When: 14 October, 10:00AM
  • What to bring: a laptop

Food: we will be providing lunch (pizza)

The plan for the Hackathon is to encourage work on small, self-contained improvements that can be finished in a short amount of time. Of course, people are free to work on other projects if they would prefer. Racket developers will be around to give advice and help.

Some suggested projects are listed below. The main categories are documentation improvements, FFI bindings, and web APIs.

To make documentation improvements, fork the Racket git repo and make your changes there. Most of the core documentation can be found at collects/scribblings/. When you're done, submit a pull request and a developer will review and suggest changes or merge it. For help with pull requests, see the GitHub help page.

For other projects, PLaneT is probably the appropriate distribution channel. For help with making a PLaneT package, see this page or ask around. Neil Van Dyke's McFly tool is also helpful.

If you claim a project, mark it on the wiki.

Documentation improvements

See the Scribble getting started page for how to write documentation and also the Reference style guide.

  • Add code examples to Reference sections that lack or have few examples. Our goal is to have examples for all Reference entries. Some places to look: string ports, reading, delayed evaluation, and so on. (Kevin & Michael & Xiangqi)

  • Expand short Guide sections. Some sections are too short to explain difficult features, such as continuations and control.

  • Create more tutorials. Some suggested topics:

    • Writing a GUI application
    • How to write & understand macros (Ryan & Claire)
    • Tutorial on classes, OO (Matthias & Danny) DONE http://www.ccs.neu.edu/home/matthias/Thoughts/Programming_with_Class_in_Racket.html
    • Development how-to. (using raco, setting up your environment, writing tests, etc.)
    • How to get the most out of Racket tools (e.g., debugger, macro stepper) with screenshots
    • Extended FFI tutorial (Chris, after getting Java FFI working)

  • Add a detailed example to the profiler manual.

FFI Bindings

Web APIs

Misc

  • Write a version of the shootout fannkuch-redux benchmark. Currently the only missing Racket program. (Danny Yoo is working on this)
  • A harder project for someone with JS and maybe Racket webserver chops: something like tryclj.com for Racket that looks nice and possibly comes with a tutorial. Useful things to know: jquery-console, the Racket sandbox.
  • Hack on TR (Neil & Vincent)

Results

Add links here to commits, repositories, pull requests, web pages, or anything else that's a result of the Hackathon.