rails/rails — pull request #7493 by steveklabnik (2012-08-31 03:25:21+00:00)
Title: Re-writing the AJAX Guide

I did a poll on Twitter to see what parts of Rails needed documentation the most, and one glaring thing that was pointed out was how out of date the AJAX guide was.

Currently, this request is not ready to be merged, but I wanted to get some feedback on what I plan to do before I bother to write the entire thing.

Basically, I built a new outline, and threw a quick paragraph or two together for a bunch of the parts.

Current guide (NOT the one I'm working on) is [here](http://edgeguides.rubyonrails.org/ajax_on_rails.html), for reference.

## Questions

Some specific feedback I'd like addressed before I flesh this out more:

### Intro to AJAX

When this guide was written, AJAX was a bit newer of a technique. The original guide had an explanation of what AJAX is. Now that everybody knows what's up, do we still need this?

### library coverage

I plan on (and have in the outline) linking to a bunch of different projects that are used for testing JS, for example. Is the 'give a bunch of them a paragraph and a link' something we want here?

### SPAs?

I wrote up a little section mentioning Ember, Backbone, and Throne of JS. Obviously, "How to write a heavy JS app" is out of the scope of this guide, but I felt that mentioning tools that people can transition to once they get a lot of JS going would make sense. Is this useful?

/cc @fxn @radar @wycats @dhh