Initial Photon (4.8) porting guide
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.8/faq.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/faq.html
new file mode 100644
index 0000000..4ac5af0
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/faq.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) 2017 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
+<title>Eclipse JDT Photon (4.8) Plug-in Migration FAQ</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT Photon (4.8) Plug-in Migration FAQ</h1>
+
+<ol>
+ <li>None</li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.8/incompatibilities.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/incompatibilities.html
new file mode 100644
index 0000000..42274d4
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/incompatibilities.html
@@ -0,0 +1,19 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) 2017 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
+<title>Incompatibilities between Eclipse JDT 4.7 and 4.8</title>
+</head>
+<body>
+<h1>Incompatibilities between Eclipse JDT 4.7 and 4.8</h1>
+
+<p>
+ So far Eclipse did not change incompatibly between 4.7 and 4.8 in ways that affect
+ plug-ins. Plug-ins that ran on 4.7 should run on 4.8 without any problems.
+</p>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/4.8/recommended.html b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/recommended.html
new file mode 100644
index 0000000..dffad0e
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/4.8/recommended.html
@@ -0,0 +1,23 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+<head>
+<meta name="copyright" content="Copyright (c) 2017 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
+<title>Adopting JDT Photon (4.8) mechanisms and APIs</title>
+</head>
+
+<body>
+
+<h1>Adopting JDT Photon (4.8) mechanisms and APIs</h1>
+<p>
+ This section describes changes that are required if you are trying to change
+ your 4.7 plug-in to adopt the 4.8 mechanisms and APIs.
+</p>
+
+<ol>
+ <li>None</li>
+</ol>
+</body>
+</html>
diff --git a/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_8_porting_guide.html b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_8_porting_guide.html
new file mode 100644
index 0000000..3a6c9a2
--- /dev/null
+++ b/bundles/org.eclipse.jdt.doc.isv/porting/eclipse_4_8_porting_guide.html
@@ -0,0 +1,39 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html lang="en">
+
+<head>
+
+<meta name="copyright" content="Copyright (c) IBM 2017 Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
+
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
+<title>Eclipse JDT Photon (4.8) Plug-in Migration Guide</title>
+</head>
+
+<body>
+
+<h1>Eclipse JDT Photon (4.8) Plug-in Migration Guide</h1>
+<p>This guide covers migrating Eclipse JDT 4.7 plug-ins to Eclipse JDT 4.8.</p>
+<p>One of the goals of Eclipse 4.8 was to move Eclipse forward while remaining compatible
+ with previous versions to the greatest extent possible. That is, plug-ins written
+ against the Eclipse 4.7 APIs should continue to work in 4.8 in spite of the
+ API changes.</p>
+<p>The key kinds of compatibility are API contract compatibility and binary compatibility.
+ API contract compatibility means that valid use of 4.7 APIs remains valid for
+ 4.8, so there is no need to revisit working code. Binary compatibility means
+ that the API method signatures, etc. did not change in ways that would cause
+ existing compiled ("binary") code to no longer link and run with the
+ new 4.8 libraries.</p>
+<p>While every effort was made to avoid breakage, there are a few areas of incompatibility or new
+ APIs that should be adopted by clients.
+ This document describes those areas and provides instructions for migrating 4.7 plug-ins to
+ 4.8.</p>
+<ul>
+ <li><a href="4.8/faq.html">Eclipse JDT 4.8 Plug-in Migration FAQ</a></li>
+ <li><a href="4.8/incompatibilities.html">Incompatibilities between Eclipse JDT 4.7 and 4.8</a></li>
+ <li><a href="4.8/recommended.html">Adopting 4.8 mechanisms and API</a></li>
+</ul>
+
+</body>
+</html>
\ No newline at end of file
