Initial Photon (4.8) porting guide
diff --git a/bundles/org.eclipse.platform.doc.isv/porting/4.8/faq.html b/bundles/org.eclipse.platform.doc.isv/porting/4.8/faq.html
new file mode 100644
index 0000000..1664cc0
--- /dev/null
+++ b/bundles/org.eclipse.platform.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 Photon (4.8) Plug-in Migration FAQ</title>
+</head>
+
+<body>
+
+<h1>Eclipse Photon (4.8) Plug-in Migration FAQ</h1>
+
+<ol>
+ <li>None</li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.platform.doc.isv/porting/4.8/incompatibilities.html b/bundles/org.eclipse.platform.doc.isv/porting/4.8/incompatibilities.html
new file mode 100644
index 0000000..1e8f232
--- /dev/null
+++ b/bundles/org.eclipse.platform.doc.isv/porting/4.8/incompatibilities.html
@@ -0,0 +1,30 @@
+<!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=UTF-8">
+<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 4.7 and 4.8</title>
+</head>
+
+<body>
+
+<h1>Incompatibilities between Eclipse 4.7 and 4.8</h1>
+
+<p>
+ Eclipse changed in incompatible ways between 4.7 and 4.8 in ways that affect
+ plug-ins. The following entries describe the areas that changed and provide
+ instructions for migrating 4.7 plug-ins to 4.8. Note that you only need to look
+ here if you are experiencing problems running your 4.7 plug-in on 4.8.
+</p>
+<p>
+See also the list of <a href="../removals.html">deprecated API removals</a> for this release.
+</p>
+
+<ol>
+<li>None at this point</a></li>
+</ol>
+
+</body>
+</html>
diff --git a/bundles/org.eclipse.platform.doc.isv/porting/4.8/recommended.html b/bundles/org.eclipse.platform.doc.isv/porting/4.8/recommended.html
new file mode 100644
index 0000000..1f1ab02
--- /dev/null
+++ b/bundles/org.eclipse.platform.doc.isv/porting/4.8/recommended.html
@@ -0,0 +1,25 @@
+<!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 Photon (4.8) mechanisms and APIs</title>
+</head>
+
+<body>
+
+<h1>Adopting 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.platform.doc.isv/porting/eclipse_4_8_porting_guide.html b/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_8_porting_guide.html
new file mode 100644
index 0000000..6c89489
--- /dev/null
+++ b/bundles/org.eclipse.platform.doc.isv/porting/eclipse_4_8_porting_guide.html
@@ -0,0 +1,35 @@
+<!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 Photon (4.8) Plug-in Migration Guide</title>
+</head>
+
+<body>
+
+<h1>Eclipse Photon (4.8) Plug-in Migration Guide</h1>
+<p>This guide covers migrating Eclipse 4.7 plug-ins to Eclipse 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 any 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 4.8 Plug-in Migration FAQ</a></li>
+ <li><a href="4.8/incompatibilities.html">Incompatibilities between Eclipse 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>
