Reviewed by Maciej, Darin.
[WebKit-https.git] / WebKitSite / projects / compat / index.html
1 <?php
2         $title = "Web Site Compatibility";
3         include("../../header.inc");
4 ?>
5 <h2>Web Site Compatibility</h2>
6
7 <h3>Overview</h3>
8 <p>The most important task that we are working on in WebKit is improving web site compatibility.  Web site compatibility is actually
9 a generic term that covers bugs that may occur in many different functional areas of the code, from CSS to rendering to plug-ins.
10 Any time you encounter a web site that works in another browser but fails in a WebKit browser you have hit a web site compatibility
11 bug.
12 </p>
13 <p>These bugs can range from minor rendering defects to showstoppers that make an entire site inaccessible.  The causes of these bugs
14 are also wide-ranging, from bugs in the way the web page is coded to bugs in the engine itself.  For this reason reduction of web site
15 compatibility bugs is a top priority.  Only if the bug is reduced to a minimal failing test case is it easy for a developer to determine the
16 root cause of the problem.</p>
17
18 <p>Web site compatibility bugs fall into several categories:</p>
19 <ol>
20 <li>The bug is in the Web site itself.  You can test this assumption by checking the site in other browsers like Firefox and
21 Internet Explorer for Windows.  If both of these browsers
22 also fail on the site, it's a safe bet that the site is to blame.
23 <li>The HTML on the site is buggy, but WebKit's error recovery does not match other browsers.  This is a very common scenario for WebKit
24 as our error handling is still a bit more strict than other browsers.  In this case the bug is still our responsibility, since whenever
25 possible we want to match other browsers' error recovery behavior.
26 <li>WebKit has a legitimate compliance bug.  This is the most important class of compatibility bug, since we especially want valid
27 HTML to render and behave properly.
28 </ol>
29
30 <h3>Get Involved!</h3>
31 <p>How can you help us improve web site compatibility in Safari?</p>
32 <dt>Test Test Test!</dt>
33 <dd>Build the latest WebKit and use it day to day.  Visit all of your favorite Web sites and scrutinize them all closely.  Make sure
34 they all work as expected, and if they don't then report problems to us.
35 <dt>File Bugs</dt>
36 <dd><a href="../../quality/reporting.html">Report bugs</a> to us for any problems you find.  Get bugs into our database so that we
37 can track the issue and screen the bug.</dd>
38 <dt>Reduce Bugs</dt>
39 <dd>Scan the bugs in the <a href="hitlist.html">Compatibility Hit List</a> and the <tt>New Bugs</tt> component and help attach reductions and minimal failing test cases.  Only when bugs are
40 screened properly will a developer be able to determine the root cause of the problem and move it into the appropriate component.
41 <i>This is one of the most important ways you can help improve WebKit.</i>
42 <dt>Create New Tests</dt>
43 <dd>To help avoid regressions you can make new tests, even for features that WebKit already handles correctly.  The more regression tests
44 we have covering a specific feature, the less likely it is that the feature will break when we make changes.
45
46 <?php
47         include("../../footer.inc");
48 ?>