Hi,
First off, I'm glad to hear you're working on documentation (it's
sorely needed, and I need all the help I can get with it).
Homepage Features is kind of a deprecated feature: I used to use it on
Curbly to do a slideshow of featured posts on the home page, but
haven't used it anywhere for a long time. Basically, a
homepage_feature is just an item with a title, text and link that you
can use to promote blog posts, users, whatever you like. There's no
default implementation for it in CE, though, so if you want to use it,
you'll have to do HomePage.feature.find(:all) in the controller where
you want to display them.
Ads is undocumented, but actually quite useful. An Ad is an object
with a 'location' string and a chunk of html. It's a way to allow you
to put arbitrary HTML (or javascript) into pages. So, for example, if
you wanted to show an ad on the homepage somewhere, then in
site_index.html.haml, you'd add:
Ad.display(:homepage_ad, logged_in?)
And then you could create Ad objects with the location 'homepage_ad',
and they'll show up on the homepage. Ads support start and end times,
can be targeted to specific groups of users (logged_in, logged_out,
everyone), and can be rotated by weight (multiple ads with the same
location will randomly appear in that spot with frequency according to
their weight).
Hope this helps,
Thanks,
Bruno