| <html> |
| <head> |
| <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <link rel="stylesheet" href="../..//default_style.css" type="text/css"> |
| <link rel="stylesheet" href="../..//webtools/wtp.css" type="text/css"> |
| <title>web tools platform adopters</title> |
| </head> |
| <body> |
| <table width="100%" cellspacing="5" cellpadding="2" border="0"> |
| <tbody> |
| <tr> |
| <td width="60%" align="left"><font class="indextop">WTP Adopters</font> |
| <br> |
| <font class="indexsub">web tools platform adopters</font></td><td width="40%"><img width="207" hspace="50" height="129" align="middle" src="../..//webtools/images/wtplogosmall.jpg"></td> |
| </tr> |
| </tbody> |
| </table> |
| <table width="100%" cellspacing="5" cellpadding="2" border="0"> |
| <col width="16"> |
| <col width="*"> |
| <tbody> |
| <tr> |
| <td valign="top" bgcolor="#0080c0" align="left" colspan="2"><b><font face="Arial,Helvetica" color="#ffffff">Introduction</font></b></td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| WTP is a |
| <em>platform</em> |
| and so adoption by others is a major goal of the project. |
| You are a WTP |
| <em>adopter</em> |
| if you are a commercial vendor or an Open Source project |
| that is using or is planning to use WTP in one or more of |
| your products. This page lists information for WTP adopters. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="#hot-bugs">Hot Bugs</a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="#non-api-code-deprecation-policy"> |
| Non-API Code Deprecation Policy |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" bgcolor="#0080c0" align="left" colspan="2"><b><font face="Arial,Helvetica" color="#ffffff"> |
| <a name="hot-bugs">Hot Bugs</a> |
| </font></b></td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| The WTP project gives high priority to bugs that promote |
| adoption. If you are an adopter and need a fix for an |
| upcoming release, please follow the |
| <a href="hot_bug_process.html">hot bug process</a> to |
| request that your bug be placed on the Hot List. We can't |
| guarantee that we'll fix every Hot Bug, but we will give |
| them high priorties. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="../plans/1.5/adopter-hotlist-report.html"> |
| WTP 1.5 Adopter Hot Bug List |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="../plans/1.0.3/ramp-down-bugs-approval.html"> |
| WTP 1.0.3 Adopter Hot Bug List |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="../plans/1.0.2/adopter-hotlist-report.html"> |
| WTP 1.0.2 Adopter Hot Bug List |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="../plans/1.0.1/adopter-hotlist-report.html"> |
| WTP 1.0.1 Adopter Hot Bug List |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"><img width="16" height="16" border="0" src="../..//images/Adarrow.gif"></td><td> |
| <a href="../plans/1.0/adopter-hotlist-report.html"> |
| WTP 1.0 Adopter Hot Bug List |
| </a> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" bgcolor="#0080c0" align="left" colspan="2"><b><font face="Arial,Helvetica" color="#ffffff"> |
| <a name="non-api-code-deprecation-policy"> |
| Non-API Code Deprecation Policy |
| </a> |
| </font></b></td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <h4>Status</h4> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| The following policy is currently under discussion. We |
| expect to finalize it and implement it by mid-January. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <h4>Policy</h4> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| WTP 1.0 does not include APIs for all functions that |
| adopters may require. Adopters therefore may elect to use |
| non-API code on the understanding that this code is subject |
| to change in future releases. Although we are not |
| technically obligated to preserve the non-API code in WTP |
| 1.5, we will make a best effort attempt to do so. We will |
| attempt to gracefully deprecate the non-API code for one or |
| two releases before completely removing it and forcing |
| adopters to migrate. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| Since there is a lot of non-API code, we need to focus on |
| the portions of it that adopters are actually using. |
| Furthermore, we need to give the WTP development team tools |
| to determine if they are potentially breaking any adopter |
| product. Avoiding breakage in important, frequently used |
| non-API code will also be good practice for us in |
| preparation for evolving our API code in a non-breaking way. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| We will therefore implement a deprecation policy for the |
| transition from WTP 1.0 to 1.5. Here are the main points: |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <ol> |
| |
| <li> |
| WTP will provide to adopters a simple build tool they |
| can use to scan their code and generate a report of |
| their usage of WTP code that can be provided to the WTP |
| development team, e.g. by attaching it to a Bugzilla |
| report. The reports will be purely statistical (usage |
| counts) and not reveal any details about the adopter's |
| code in order to preserve privacy. Adopters who |
| volunteerily opt in to this reporting process will |
| benefit from our efforts to reduce potential breakage in |
| their code as WTP evolves its code. |
| </li> |
| |
| |
| <li> |
| WTP will provide to its developers a build tool that |
| scans our code and detects breakage in both API and |
| non-API code. Known API breakage will be considered a |
| "blocker" P1 bug. Breakage in non-API code will be |
| flagged if there is significant adopter usage of it, in |
| which case an effort will be made to preserve the |
| non-API code, or provide migration documentation. The |
| techniques used to evolve API code will be applied to |
| the important non-API code on a best efforts basis. In |
| cases where breakage is unavoidable, affected adopters |
| will be notified. |
| </li> |
| |
| |
| <li> |
| When feasible, WTP will deprecate important non-API code |
| for a period of at least one major release. Adopters |
| will be encouraged to migrate to the new version between |
| releases. |
| </li> |
| |
| |
| <li> |
| WTP will review the non-API usage reports for cases |
| where adopters are not using available API code and we |
| will inform adopters that API alternatives exist and |
| that they should migrate to them. WTP will not apply the |
| above deprecation policy to non-API code where API |
| alternatives exist. That is, adopters will be informed |
| of the API alternatives and given migration |
| instructions. Adopters will be required to migrate to |
| the WTP 1.0 API alternatives if we deem it necessarily |
| or advisable to remove the non-API code in WTP 1.5. |
| </li> |
| |
| |
| <li> |
| WTP will review the non-API usage reports and use that |
| information to prioritise the evolution of non-API code |
| to API code. Non-API code that has high adopter usage |
| will be given the highest priority. |
| </li> |
| |
| </ol> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" bgcolor="#0080c0" align="left" colspan="2"><b><font face="Arial,Helvetica" color="#ffffff">Tool to generate WTP usage report and determine non-API breakages</font></b></td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| Click <a href="scan4breakage.html">here</a> to learn how to scan for |
| adopter breakages as you develop code using Eclipse. |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td valign="top" align="right"> </td><td valign="top"> |
| <p> |
| Click <a href="tool.html">here</a> to learn how to run the adopter breakage |
| tool in your build. |
| </p> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </body> |
| </html> |