Seriously Sound Science™
Designing Documents for the World-Wide Web
This article is part of a series about developing for and publishing via the World-Wide Web. The series begins with An Introduction to the World-Wide Web.
In designing their Web pages, all publishers must comply with legal and technical requirements while attempting to maximize the value provided by each page by making pages accessible and useful to the greatest number of potential potential users. Some of the most significant topics for consideration are addressed below.
Publishing works via the World-Wide Web is fundamentally no different than publishing them using any other means. The same basic rules of law apply, though with some additional caveats.
Americans with Disabilities Act
The first of the legal caveats that all Web publishers should recognize are the effects of the United States federal Americans with Disabilities Act. Among many other things, the A.D.A. requires that all Web pages be equally-accessible to those with physical disabilities or handicaps. Yet, many entire Web sites are not accessible to handicapped users per A.D.A. guidelines.
The most notorious and prolific culprits are the many Web site designers who – apparently oblivious to even the existence of the A.D.A. – require all potential users of their sites to download and run the Adobe/Macromedia Flash plug-in. This makes the site's information inaccessible to search engines, those wishing not to use the plug-in, those using computers not supported by the plug-in, and – most importantly – those unable to use the plug-in due to physical handicaps, which thereby violates the A.D.A. and exposes the operator to severe liability. (Any practitioner with such a callous disregard for the basic laws governing his or her craft quickly becomes guilty of professional malpractice.) One prime example of how not to publish using Flash-enabled content is the Texas Renaissance Festival Web site.
Any Web site may easily include Flash-enabled content, but the home page and all other information should be presented in an A.D.A.-compliant text-based format. Any Flash-enabled content may only duplicate the information already presented in A.D.A.-compliant form.
Children's Online Privacy Protection Act
Intellectual property includes any idea reduced to tangible form. On Web sites, this includes works usually protected by copyright and trademark law. Copyright violations include the republication of works – such as text, images (including Yahoo! or Google maps), animation, music, or video – without the consent of the copyright holder. Trademark violations include the use of a trademark (or "service mark") without the consent of the mark's owner.
The World-Wide Web represents a subset of Internet data communication. Technical standards for Web publication are established by the World-Wide Web Consortium (W3C).
The W3C provides a free validation tool to aid Web publishers. (See the "W3C" validation icons near the bottom of this page.) This tool should be used to validate all pages published on the World-Wide Web.
The registration and use of domain names are regulated by the Internet Corporation for Assigned Names and Numbers (ICANN), which offers rules and procedures to resolve disputes through arbitration, though they largely duplicate existing federal laws and provide worse service at much higher costs. (For an example, see the "Syncopated Software" Domain Name Dispute.)
The World-Wide Web Consortium (W3C) recommends several Web Content Accessibility Guidelines. In short, these guidelines (at the time of this writing) include the following recommendations, which are listed in order of their "checkpoint" number.
In addition to the above, Syncopated offers the following additions, clarifications and amplifications.
Use Descriptive Link Text
As mentioned above (and in W3C Web Content Accessibility Guidelines checkpoint 13.1), most linked text – especially those found in bodies of text – should briefly describe each link's action, and never a non-descriptive term such as "click here". These descriptions should ideally include a noun and a verb, as in the sentence, "For more information, contact Syncopated".
Show Results, Not Implementation
When given the name of a directory, most Web servers typically attempt to display an index to the directory. If the directory contains an index file, the contents of that file are presented to the requestor. Otherwise, the server presents a listing of files in the directory.
As with all other areas of computer science, designers of Web sites should take great care to facilitate future developments by revealing as few of the mechanisms behind their implementations as possible. For example, one should publish or link to only "www.mygreatwebsite.com" instead of "www.mygreatwebsite.com/index.html", leaving it up to the Web server to determine which file to use and allowing the designer the option to later change the implementation to use server-side directives (as "index.shtml"), scripts, and so on. Similarly, by publishing or linking to only "www.mygreatwebsite.com/sometopic", one could implement the destination as a single page (resolving to "www.mygreatwebsite.com/sometopic.html") or an entire directory (resolving to "www.mygreatwebsite.com/sometopic/index.html").
Designers should also use care to avoid inadvertently revealing the contents of entire directories by placing an appropriate index files in each directory and/or configuring their server programs not to display directory listings. (In doing this, also remember that obscuring file names is a relatively poor mechanism for securing files.)
Prevent Senders of Electronic Junk Mail
Syncopated strongly recommends against publishing electronic mail addresses on Web pages. About 95% of the electronic mail Syncopated regularly receives consists of unsolicited and unwelcome commercial ("junk" or "Spam") messages, most apparently from automated senders, and nearly half of the messages of this type are sent to addresses that have been published on Web pages (with or without mailto: links). The presence and correct configuration of software needed to send Internet S.M.T.P. messages (those send via mailto: links) is not ubiquitous, and is usually not included in Web browsers.
Instead, Syncopated uses – and strongly recommends using – a mechanism that allows users of its Web site to send brief messages via a simple Web-based form; see this example on Syncopated's contact page.
Wait to Stream Media
To create the greatest utility for the greatest number of potential users, Web publishers should attempt to minimize the computing resources needed to access their pages. So, Web pages should never attempt to play sounds and, ideally, should not display animation unless specifically instructed to do so by the user.
As another unfortunate counterexample, the Oktoberfest in Fredericksburg Web site automatically plays music to all users. Though, to the publisher's credit, the music is only a low-bandwidth MIDI sequence.
Many publishers choose to delegate much of the design of their Web sites via contract to vendors outside their organizations through a process commonly referred to as outsourcing. (For further reading on business management, see An Introduction to Business and Operations Management.)
Before hiring a developer, the prospective publisher should research which potential vendors are available and qualified to perform the work. When seeking service providers, this vendor qualification process usually involves reviewing samples of each potential vendor's prior work. Specifically for qualifying Web site developers, this should include verifying that the work for which credit is claimed was actually performed by the vendor, and that the site meets all legal, technical and client requirements, including those described above.
One may quickly evaluate the quality of Web sites (and through them, their developers) using a process such as the following:
In ranking others' sites, Syncopated uses the traditional American academic letter grades "A", "B", "C", "D" and "F" – with "A" being the best and "F" being a failure – subtracting from a perfect score one-third of a letter grade for any detected occurrence(s) of each non-critical fault.
For information about selecting a local vendor for outsourced Web site development, see Austin Area Web Site Developer Rankings. (For general information about business management processes, see also An Introduction to Business and Operations Management.)
|Syncopated attempts to present a model Web site that meets or exceeds all applicable technical and legal requirements, including those of the A.D.A., COPPA, ICANN and W3C.
|Style sheet validated
|"Syncopated Systems" and "Syncopated Software" are registered trademarks of, the interlaced tuning forks and "recreate reality" devices are trademarks of, and all contents (except as otherwise noted) copyright ©2004-2008 the Syncopated Software Development Corporation. ALL RIGHTS RESERVED. Any reproduction without written permission or other infringement is prohibited by United States and international laws.