Doug DeJulio's Attempt at Lab 1b


Site List

Here are a few sites that are decent when judged by the criteria we were given.

  1. Apache Week
  2. Wikipedia
  3. MyWay
  4. ThinkGeek
  5. JavaDoc sites in general

Details

Apache Week

The Apache Week web site is the web interface to the weekly mailing list "Apache Week". It's an invaluable resource for people who wish to keep up to date on the state of the Apache web server.

It meets the criteria for content. It's the single best source on the internet for up-to-date information on Apache. Among the editors of the newsletter is one of the directors of the Apache project, so they're very well-connected to the Apache development community. They've been running the service since 1996, and they have all of their back-issues on line.

It meets the criteria for navigation. The front page has this week's topics separated into categories with simple abstracts for each one. This is the primary interface most people will use. The secondary site functions (such as searching and browsing the archives) are available in an unobtrusive sidebar that does not surprise the user with unexpected dynamic behavior (such as flashing buttons or popups).

It meets the criteria for design. Being a web interface for a newsletter, the page is fundamentally simple. However, it makes use of small graphics, empty space, and color, to make looking at the site easier on the eyes.

It meets the criteria for mechanics. There's really no JavaScript, and even the CSS and formatting they use degrade gracefully on small displays and with browsers that do not support CSS.

Wikipedia

Wikipedia is an online encyclopedia with entirely open content, developed using an innovative, collaborative approach to content contribution.

It meets the criteria for content. It's rare to enter a search term into it and get anything other than a useful result. Despite the open content contribution policies, they have a structured enough reviewing process that almost all of the massive repository of content is actually of very high quality.

It meets the criteria for navigation. The main function of this site is searching, and there's an easy to use search box right on the front page. Once you've done a search, if you've obtained good results it's very easy to read them, but there are also easy to use links to other articles and external resources.

It meets the criteria for design. If you use this site at all you're going to be reading large amounts of text through it, and the navigation sidebar and branding graphics are small and subtle enough that they don't interfere.

It meets the criteria for mechanics. There's very little JavaScript, and it does not result in surprising behaviors. The page degrades well on small devices and on devices that don't fully support JavaScript and CSS. Searches and navigation all complete quickly.

MyWay

MyWay is an end-user customizable portal. People can navigate to the site and self-register as users. Then they can configure it to provide a "dashboard" of highly customzied and highly targeted content, such as local weather and the TV schedule for a specific set of local channels.

It meets the criteria for content. This is an end-user customizable portal. There's a lot of useful content of the sort appropriate to this role, such as weather, news headlines, and stock tickers. These are all extremely personalizable. For example, you can configure the stock ticker portlet with the number of shares of each stock you own, and it will summarize your daily profit and loss.

It meets the criteria for navigation. The arrangement of tabs, columns, and portlets is such that you can get access to a tremendous amount of information without having to scroll too much. The interface for adding content to particular pages is also easy to use.

It meets the criteria for design. It's lightweight and manages to pack information in densely, but does not cause eye strain.

It meets the criteria for mechanics, but not as well as the previous sites did. It performs quicly, but does not degrade gracefully on all devices; it does have some browser-specific behavior, and it does require JavaScript.

ThinkGeek

ThinkGeek is a web storefront targeted specificially towards "computer geeks".

It meets the criteria for content. It's got a wide variety of products, and they're categorized reasonably and also discoverable via search. For each product, there's a fairly thorough descirption and often multiple pictures, including a feature via which customers can submit photos of the products in actual use.

It meets the criteria for navigation. Product descriptions can be discovered sevearl ways: browsing, searching, a "what's new" list, and a "clearance" list. In addition, an RSS feed of the "what's new" list is provided.

It meets the criteria for design. There's a main content area, a navigation sidebar, and site controls (such as "account" and "wishlist") in the site header. The various areas are distinguished from each other visually while maintaining a basically-consistent sitewide look-and-feel. The use of photos in the product descriptions is particularly good, with support for user-provided "action shots".

It basically meets the criteria for mechanics. Navigation is quick and painless. However, it does not degrade as well as well as we might like on small devices such as PDAs.

JavaDoc

The Java programming language has a system for automatic generation of documentation from comments within the source code, called JavaDoc. The provided link is to just one example of a web site created via this system, but all Java API documentation produced by this automated tool shares the same characteristics. Here is another example, and another.

It meets the criteria for content when the tool is used properly. All of the documentation needed to use any of the Java programming interfaces is available via this mechanism.

It meets the criteria for navigation. By default, a three-frame view appears, allowing selection of Java packages in the top left frame and Java classes and interfaces in the bottom left pain, while keeping the main area available for actually reading the documentatin. However, there's a non-frame version available via one click, for users who have difficulty using frames.

It meets the criteria for design, but only barely. This is programmers reference documentation. The design does not interfere with that, but doesn't really go beyond that. It's a very bare-bones design.

It meets the criteria for mechanics. One of the important features of this system is that the pages produced must work equally well when installed on a hard disk or on to multiple different web servers -- the same documentation might be installed at many sites and on a developer's laptop. Page loads are extremely quick and make good use of the "target" attribute of anchor elements to reuse existing screen real estate in practical ways.


Doug DeJulio
ddj+@cmu.edu