Atom to the rescue
One of the benefits of using Mephisto to power this site is the way in which it supports atom feeds. This opens the doors for some great uses of the documentation. Based on the comments we've received, some folks have already started on some tools.
You can get an atom feed for any section of the Prototype API docs. I've just added the official feed icon on the right side of the title for each object page. I have plans to get these pages in hAtom format as well, but that'll come later on. In the meantime, you can get the feeds by clicking the feed icon next to the title. Feed URLs are also guessable. If you wanted to get the feed for
Form.element, you'd have something like this:
language: html http://www.bieradventures.com/feed/api/form/element/atom.xml
On to the tools
- Quick API Search: One commenter whipped up a quick bookmarklet for quickly accessing pages within the documentation. You can get it by dragging this link to your bookmarks bar.
Prototype Snippets and Language Grammar: Thomas Aylott is a TextMate machine! Grab his TextMate bundle here chocked full of stuff for Prototype. I also believe he's working on a plugin for TextMate that would allow you to search the docs. Who knows what else he'll throw in there. I'm sure it will be great once he gets it finished.
Lint Checking and Compression: Andrew has a nice plugin for lint checking and compressing your code (if you like that sort of thing). It's a very handy tool that I abuse daily.
If you're aware of other tools for Prototype, let me know and I'll post them here.
Some ideas to ponder (or take action on)
There are a lot of things we can do with the documentation. Here are some of the things I've been thinking about.
- Firefox search plugin
- Firefox sidebar
- TextMate tooltips and search
- Integration with other editors (anyone know of something like this already?)