diff --git a/bundles/org.eclipse.pde.doc.user/api_contexts.xml b/bundles/org.eclipse.pde.doc.user/api_contexts.xml
index 6ea4aac..60da578 100644
--- a/bundles/org.eclipse.pde.doc.user/api_contexts.xml
+++ b/bundles/org.eclipse.pde.doc.user/api_contexts.xml
@@ -32,9 +32,13 @@
       <topic href="http://wiki.eclipse.org/Execution_Environments" label="Execution Environments"/>
       <topic href="tasks/api_tooling_options.htm" label="Changing API Options"/>
    </context>
-      <context id="apitools_error_warning_explain_incompatibility_field_addition_class" title="'Field Addition to Class' Incompatibility">
-      <description>Adding an API field to an API class is a breaking change due to two reasons 1) Name clash 2) Possible linkage error. See the 'Add API field incompatibility' link below for details. </description>
-   		<topic href="https://wiki.eclipse.org/Evolving_Java-based_APIs_2#add-api-field" label="Add API field incompatibility"/>
+   <context id="apitools_error_warning_explain_incompatibility_field_addition_class" title="'Field Addition to Class' Incompatibility">
+      <description>Adding an API field to an API class is considered a breaking change for two reasons:
+1) Potential name clash
+2) Potential linkage error
+However, field additions can be acceptable with proper precautions.
+See the "'Add API field' incompatibility" link below for details.</description>
+      <topic href="https://wiki.eclipse.org/Evolving_Java-based_APIs_2#add-api-field" label="'Add API field' incompatibility"/>
    </context>
    <context id="apitools_error_warning_prop_page" title="API Errors/Warnings">
       <description>This page allows you to configure project specific settings for problem severities related to API compatibility and use.</description>
@@ -127,5 +131,5 @@
       <description>The API Use Report launch configuration runs a use scan reporting API references, internal references, and illegal API use.</description>
       <topic href="reference/api-tooling/ant-tasks/apiuse-ant-task.htm" label="API Use Scan Report Task"/>
       <topic href="reference/api-tooling/ant-tasks/apiuse-reportconversion-ant-task.htm" label="API Use Scan Report Conversion Task"/>
-   </context>  
+   </context>
 </contexts>