Tags

Showing posts with label usability. Show all posts
Showing posts with label usability. Show all posts

Tuesday, February 8, 2011

Ruby on Rails Docs Done Right

The official Ruby on Rails API site uses the same tri-frame layout employed in the Java API site, except that the Java site's show-classes-by-package feature doesn't apply. The way to search either of these is to use your browser's "find" feature (ctrl+F). I find this setup rather irksome.

Fortunately, Vladimir Kolesnikov has brought us railsapi.com, a searchable Rails API site. It's available to use online or to download and use offline. The search returns matches by relevance and picks up on inexact matches.  Below are links to the online API.

Rails version 3: http://railsapi.com/doc/rails-v3.0.3/

Rails version 2: http://railsapi.com/doc/rails-v2.3.8/

Thanks, Vlad!

EDIT (Feb 2015): railsapi.com is no longer up. But the official Ruby on Rails API site now boasts a clean design with highly responsive search. See it here: http://api.rubyonrails.org/

Monday, September 24, 2007

Building the Kingdom with Mormon.org

The Church uses the Internet to advance the work of the gospel on various fronts. In particular, I've recently looked at http://www.mormon.org/. Its layout is simple and effective. I first noticed the video clips, each with a convert to the Church relating how his or her questions about life found answers in the Gospel of Jesus Christ. Now I click on the Basic Beliefs link; as the categories appear, I recognize the lessons and principles in the Preach My Gospel manual from which missionaries teach. This well-organized set of lessons would be excellent for anyone who browses the site to learn about the church, and even better for investigators who wish to review these same lessons the missionaries have taught them.

The Church webmasters have gone beyond simply publishing information about the Church to the Web. They have selected features that give the Internet an advantage over other publishing forms. A video clip accompanies each principle. Visitors can customize and send gospel-themed e-cards. They can type in a specific question and find an answer, or find the time and place of the nearest Sacrament meeting, complete with a MapQuest map.

It especially caught my attention that site visitors can chat with a member of the Church live. Church magazine articles warn that too often the anonymity of online chat hides predators or inappropriately lifts inhibitions. I am glad to see mormon.org make careful use of online chat for a good cause. Because of the Internet's anonymity, people who are not yet ready to announce their interest in the Church can learn more, and learning prepares them to take further steps.

Overall, I see a website that has been attentively shaped and polished to assist in the Lord's work of proclaiming the gospel. Kudos to the minds behind mormon.org for the wise steps they have taken in building the kingdom.