Improve and fix the markdown documentation

- Add a .project file to `docs` folder  for a project named
`org.eclipse.platform.ui.docs`
- Remove internal table of content entries.
- Fix broken links and avoid absolute raw and self links.

Author: merks

docs/.project

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>org.eclipse.pde.ui.docs</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+	</buildSpec>
+	<natures>
+	</natures>
+</projectDescription>

docs/.settings/org.eclipse.core.resources.prefs

@@ -0,0 +1,2 @@
+eclipse.preferences.version=1
+encoding/<project>=UTF-8

docs/Accessibility_Features.md

@@ -14,24 +14,24 @@ Having said that there are places within the Platform UI that have been given so
 
 The TitleAreaDialog is the abstract superclass of WizardDialog and PreferenceDialog among others. It has an area that is used to display status and error messages. When an error is displayed a user using an assistive technology such as a screen reader may need to give focus to the error in order to read it. We do this by using a non editable Text rather than a label in the message area of the dialog.
 
-![Titleareadialog.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/Titleareadialog.png)
+![Titleareadialog.png](images/Titleareadialog.png)
 
 **IconAndMessageDialog**
 
 Screen readers try and do thier best to read the content of a dialog but tend to give up when they hit the first non labelled child of the Shell. We changed the IconAndMessageDialog (parent of MessageDialog, ErrorDialog and many others) to have a label that is a direct child of the shell so that it is already read.
 
-![Confirm.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/Confirm.png)
+![Confirm.png](images/Confirm.png)
 
 **High Contrast Presentation Change**
 
 Eclipse ships with 2 presentations - the default presentation (which uses the font settings defined in the JFace resources properties for each platform and Locale) and the system default presentation which only uses the system fonts and colours. When you switch into High Contrast Mode Eclipse will prompt you for a restart and switch the presentation to the default one.
 
-![Highcontrast.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/Highcontrast.png)
+![Highcontrast.png](images/Highcontrast.png)
 
 
 **Accessible Listeners**
 
 In places where we do not provide information that can be read by default by a screenreader we use the SWT IAcccesibleListener interface to specify a value. The Windows inspect32 tool is a good way to see the information a screenreader will get. Below is a screenshot of the ColorFieldEditor with the inspect32 window open.
 
-![Accessiblelistener.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/Accessiblelistener.png)
+![Accessiblelistener.png](images/Accessiblelistener.png)
 

docs/CSS.md

@@ -1,20 +1,6 @@
 Eclipse 
 ======
 
-Contents
---------
-
-*   [1 Overview](#Overview)
-*   [2 Sample](#Sample)
-*   [3 SWT Mapping](#SWT-Mapping)
-    *   [3.1 Widget: Control](#Widget-Control)
-    *   [3.2 Widget: Button](#Widget-Button)  
-    *   [3.3 Widget: Label](#Widget-Label)
-    *   [3.4 Widget: CTabFolder](#Widget-CTabFolder)
-    *   [3.5 Widget: CTabItem](#Widget-CTabItem)
-    *   [3.6 Widget: CTabFolder with e4Renderer](#Widget-CTabFolder-with-e4Renderer)
-*   [2 Pseudo classes which can be used in CSS to style SWT widgets](#Pseudo-classes-which-can-be-used-in-CSS-to-style-SWT-widgets)
-*   [3 Using CSS in Eclipse 3.6](#Using-CSS-in-Eclipse-36)
 
 Overview
 --------

docs/Command_Core_Expressions.md

@@ -3,25 +3,11 @@ Command Core Expressions
 
 Core expressions are declarative or programmatic expressions based on the org.eclipse.core.expressions plugin.
 
-Contents
---------
-
-*   [1 Expressions and the Command Framework](#Expressions-and-the-Command-Framework)
-*   [2 Variables and the Command Framework](#Variables-and-the-Command-Framework)
-*   [3 Property Testers](#Property-Testers)
-*   [4 Expression examples](#Expression-examples)
-    *   [4.1 Basic IStructuredSelection](#Basic-IStructuredSelection)
-    *   [4.2 Package Explorer IStructuredSelection](#Package-Explorer-IStructuredSelection)
-    *   [4.3 Active editor type](#Active-editor-type)
-    *   [4.4 Complex nested boolean expressions](#Complex-nested-boolean-expressions)
-*   [5 New Core Expressions in 3.3](#New-Core-Expressions-in-33)
-    *   [5.1 count and iterate](#count-and-iterate)
-    *   [5.2 definitions](#definitions)
 
 Expressions and the Command Framework
 =====================================
 
-The [Platform Command Framework](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/PlatformCommandFramework.md) uses [core expressions](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Platform_Expression_Framework.md) for enabledWhen and activeWhen for handlers, programmatic activation of contexts, and for visibleWhen for menu contributions. 
+The [Platform Command Framework](PlatformCommandFramework.md) uses [core expressions](Platform_Expression_Framework.md) for enabledWhen and activeWhen for handlers, programmatic activation of contexts, and for visibleWhen for menu contributions. 
 The command framework provides the IEvaluationContext that command core expressions are evaluate against.
 
 The IEvaluationContext provides a default variable for evaluations, and a number of named variables. 

docs/Eclipse4_RCP_Contexts.md

@@ -2,30 +2,10 @@ Eclipse4/RCP/Contexts
 =====================
 
 The Eclipse 4 Application Platform manages state and services using a set of _contexts_; this information is used for injection. 
-Contexts are used as the sources for [Dependency Injection](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Eclipse4_RCP_Dependency_Injection.md). 
+Contexts are used as the sources for [Dependency Injection](Eclipse4_RCP_Dependency_Injection.md). 
 In this respect, they are somewhat analogous to _modules_ in Guice. 
 Normally code should not have to use or know about the context.
 
-  
-
-Contents
---------
-
-*   [1 What is a Context?](#What-is-a-Context)
-*   [2 The Use of Contexts in Eclipse 4](#The-Use-of-Contexts-in-Eclipse-4)
-*   [3 Context Variables](#Context-Variables)
-*   [4 Context Chains and the Active Context](#Context-Chains-and-the-Active-Context)
-*   [5 Context Functions](#Context-Functions)
-*   [6 Run And Tracks](#Run-And-Tracks)
-*   [7 Exposing Services and State on an Eclipse Context](#Exposing-Services-and-State-on-an-Eclipse-Context)
-    *   [7.1 Context Functions](#context-functions-1)
-    *   [7.2 OSGi Services](#OSGi-Services)
-    *   [7.3 Context Functions Exposed As OSGi Declarative Services](#Context-Functions-Exposed-As-OSGi-Declarative-Services)
-*   [8 Creating New Contexts](#Creating-New-Contexts)
-*   [9 Advanced Topics](#Advanced-Topics)
-    *   [9.1 How do I access the current context?](#How-do-I-access-the-current-context)
-    *   [9.2 @Active vs ACTIVE_*](#active-vs-active_)
-*   [10 References](#References)
 
 What is a Context?
 ------------------
@@ -36,7 +16,7 @@ A context (a IEclipseContext) is a hierarchical key-value map. The keys are stri
 The Use of Contexts in Eclipse 4
 --------------------------------
 
-![300px-Ui-context-hierarchy.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/300px-Ui-context-hierarchy.png)
+![300px-Ui-context-hierarchy.png](images/300px-Ui-context-hierarchy.png)
 
 
 Eclipse 4 associates contexts to the container elements in the UI
@@ -85,7 +65,7 @@ By declaring a context variable for the master server, if we later decide that w
 Context Chains and the Active Context
 -------------------------------------
 
-![300px-Ui-contexts-active.png](https://raw.githubusercontent.com/eclipse-platform/eclipse.platform.ui/master/docs/images/300px-Ui-contexts-active.png)
+![300px-Ui-contexts-active.png](images/300px-Ui-contexts-active.png)
 
 The editor is the active leaf
 

docs/Eclipse4_RCP_Dependency_Injection.md

@@ -2,35 +2,6 @@ Eclipse4/RCP/Dependency Injection
 =================================
 
 
-Contents
---------
-
-*   [1 Overview](#Overview)
-*   [2 Standard Annotations and Classes](#Standard-Annotations-and-Classes)
-    *   [2.1 @Inject (jakarta.inject)](#inject-jakartainject)
-    *   [2.2 @Named (jakarta.inject)](#named-jakartainject)
-    *   [2.3 @Singleton (jakarta.inject)](#singleton-jakartainject)
-    *   [2.4 Provider (javax.inject)](#provider-javaxinject)
-    *   [2.5 @PostConstruct (jakarta.annotation), @PreDestroy(jakarta.annotation)](#postconstruct-jakartaannotation-predestroyjakartaannotation)
-*   [3 E4AP-specific Annotations](#e4ap-specific-annotations)
-    *   [3.1 @Optional (org.eclipse.e4.core.di.annotations)](#optional-orgeclipsee4corediannotations)
-    *   [3.2 @Active (org.eclipse.e4.core.contexts)](#active-orgeclipsee4corecontexts)
-    *   [3.3 @Preference (org.eclipse.e4.core.di.extensions)](#preference-orgeclipsee4corediextensions)
-    *   [3.4 @Creatable (org.eclipse.e4.core.di.annotations)](#creatable-orgeclipsee4corediannotations)
-    *   [3.5 @CanExecute, @Execute (org.eclipse.e4.core.di.annotations)](#.canexecute-execute-orgeclipsee4corediannotations)
-    *   [3.6 @Focus (org.eclipse.e4.ui.di)](#focus-orgeclipsee4uidi)
-    *   [3.7 @AboutToShow, @AboutToHide (org.eclipse.e4.ui.di)](#abouttoshow-abouttohide-orgeclipsee4uidi)
-    *   [3.8 @GroupUpdates (org.eclipse.e4.core.di.annotations)](#groupupdates-orgeclipsee4corediannotations)
-    *   [3.9 @EventTopic (org.eclipse.e4.core.di.extensions), @UIEventTopic (org.eclipse.e4.ui.di)](#eventtopic-orgeclipsee4corediextensions-uieventtopic-orgeclipsee4uidi)
-*   [4 Advanced Topics](#Advanced-Topics)
-    *   [4.1 Injection Order](#Injection-Order)
-    *   [4.2 Extending the DI Framework](#Extending-the-DI-Framework)
-    *   [4.3 Configuring Bindings](#Configuring-Bindings)
-*   [5 Debugging](#Debugging)
-*   [6 Considerations](#Considerations)
-*   [7 Current Caveats](#Current-Caveats)
-*   [8 Design Decisions](#Design-Decisions)
-
 Overview
 ========
 
@@ -131,7 +102,7 @@ However, if this annotation is specified, then:
 @Active (org.eclipse.e4.core.contexts)
 --------------------------------------
 
-@Active serves a similar purpose to @Named, indicating the the value should be resolved from the [active context](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Eclipse4_RCP_Contexts.md).
+@Active serves a similar purpose to @Named, indicating the the value should be resolved from the [active context](Eclipse4_RCP_Contexts.md).
 
 For example, a handler could obtain the active part with:
 
@@ -286,7 +257,7 @@ The setInfo() method will be triggered by a call to IEclipseContext#processWaiti
 
 The @EventTopic and @UIEventTopic annotations tag methods and fields that should be notified on event changes. 
 The @UIEventTopic ensures the event notification is performed in the UI thread. Both the event's DATA object and the actual OSGi Event object (org.osgi.service.event.Event) is available. 
-See the [Events](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Event_Model.md) section for more details about events.
+See the [Events](Event_Model.md) section for more details about events.
 
     @Inject
     public void setSelection(@EventTopic(REFRESH_EVENT) Object data) {
@@ -296,7 +267,7 @@ See the [Events](https://github.com/eclipse-platform/eclipse.platform.ui/blob/ma
 Advanced Topics
 ===============
 
-Injection is performed using the active [context](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Eclipse4_RCP_Contexts.md). 
+Injection is performed using the active [context](Eclipse4_RCP_Contexts.md). 
 Changes to values in the context will trigger re-injection.
 
 *   *   Adding, setting, or modifying variables

docs/Eclipse4_RCP_EAS_List_of_All_Provided_Services.md

@@ -1,36 +1,8 @@
 Eclipse4/RCP/EAS/List of All Provided Services
 ==============================================
 
-This page provides a listing of the services and other data values that can be injected or obtained from a [context](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Eclipse4_RCP_Contexts.md).
-
-Contents
---------
-
-*   [1 Application Context](#Application-Context)
-    *   [1.1 Application Parameters](#Application-Parameters)
-    *   [1.2 Services](#Services)
-    *   [1.3 Runtime Data](#Runtime-Data)
-*   [2 Top Level Window Context](#Top-Level-Window-Context)
-    *   [2.1 Model Info](#Model-Info)
-    *   [2.2 Services](#Services-2)
-    *   [2.3 Runtime Data](#Runtime-Data-2)
-*   [3 Part Context](#Part-Context)
-    *   [3.1 Model Info](#Model-Info-2)
-    *   [3.2 Services](#Services-3)
-*   [4 Handler Execution](#Handler-Execution)
-*   [5 Eclipse 3.x Compatibility Layer](#Eclipse-3x-Compatibility-Layer)
-    *   [5.1 Application Context](#Application-Context-2)
-        *   [5.1.1 Application Parameters](#Application-Parameters-2)
-        *   [5.1.2 Model Info](#Model-Info-3)
-        *   [5.1.3 Services](#Services-4)
-        *   [5.1.4 Runtime Data](#Runtime-Data-3)
-    *   [5.2 Top Level Window Context](#Top-Level-Window-Context-2)
-        *   [5.2.1 Model Info](#Model-Info-4)
-        *   [5.2.2 Services](#Services-5)
-        *   [5.2.3 Runtime Data](#Runtime-Data-4)
-    *   [5.3 Part Context](#Part-Context-2)
-        *   [5.3.1 Model Info](#Model-Info-5)
-        *   [5.3.2 Services](#Services-6)
+This page provides a listing of the services and other data values that can be injected or obtained from a [context](Eclipse4_RCP_Contexts.md).
+
 
 Application Context
 -------------------

docs/Eclipse4_RCP_FAQ.md

@@ -1,53 +1,6 @@
 Eclipse4/RCP/FAQ
 ================
 
-Contents
---------
-
-*   [1 Adopting the Eclipse 4 Application Platform](#Adopting-the-Eclipse-4-Application-Platform)
-    *   [1.1 How do the Eclipse 3.x and 4.x programming models differ?](#how-do-the-eclipse-3x-and-4x-programming-models-differ)
-        *   [1.1.1 Handlers](#Handlers)
-        *   [1.1.2 Parts](#Parts)
-        *   [1.1.3 Lazy Instantiantion](#Lazy-Instantiantion)
-    *   [1.2 How would I accomplish X in Eclipse 4?](#How-would-I-accomplish-X-in-Eclipse-4)
-        *   [1.2.1 Accessing the status line](#Accessing-the-status-line)
-        *   [1.2.2 Associating help context with a control](#Associating-help-context-with-a-control)
-        *   [1.2.3 Handling errors and exceptions](#Handling-errors-and-exceptions)
-        *   [1.2.4 Accessing preference values](#Accessing-preference-values)
-        *   [1.2.5 How to I find ressource leaks in plug-ins](#How-to-find-resource-leaks)
-*   [2 The E4 Model](#The-E4-Model)
-    *   [2.1 What is an _xmi:id_? How is it different from the _elementId_?](#what-is-an-xmiid-how-is-it-different-from-the-elementid)
-    *   [2.2 How do I reference an object defined in another .e4xmi?](#how-do-i-reference-an-object-defined-in-another-e4xmi)
-    *   [2.3 Are identifiers (elementId) supposed to be unique?](#are-identifiers-elementid-supposed-to-be-unique)
-    *   [2.4 How do I use MPlaceholders?](#How-do-I-use-MPlaceholders)
-    *   [2.5 How do I create an MPart from an MPartDescriptor?](#How-do-I-create-an-MPart-from-an-MPartDescriptor)
-*   [3 Problems on Configuration, Start-Up, and Shutdown](#Problems-on-Configuration.2C-Start-Up.2C-and-Shutdown)
-    *   [3.1 Why won't my application start?](#Why-won.27t-my-application-start)
-    *   [3.2 I modified my App.e4xmi/fragment.e4xmi but the changes aren't being loaded. Why?](#i-modified-my-appe4xmifragmente4xmi-but-the-changes-arent-being-loaded-why)
-    *   [3.3 How can I prevent my workbench model from being saved on exit?](#How-can-I-prevent-my-workbench-model-from-being-saved-on-exit)
-*   [4 Dependency Injection & Contexts](#dependency-injection--contexts)
-    *   [4.1 Why aren't my @Inject-able/@PostConstruct methods being injected?](#why-arent-my-inject-ablepostconstruct-methods-being-injected)
-        *   [4.1.1 Cause #1: Mismatched Annotations](#cause-1-mismatched-annotations)
-        *   [4.1.2 Cause #2: Unresolvable Injections](#cause-2-unresolvable-injections)
-    *   [4.2 What services are available for injection?](#What-services-are-available-for-injection)
-    *   [4.3 How can I override a provided object?](#How-can-I-override-a-provided-object)
-    *   [4.4 How do I provide singleton objects?](#How-do-I-provide-singleton-objects)
-    *   [4.5 Why am I getting a new instance of an object?](#Why-am-I-getting-a-new-instance-of-an-object)
-    *   [4.6 Why is my widget/part not displaying? Why am I getting a new Shell?](#Why-is-my-widget.2Fpart-not-displaying-Why-am-I-getting-a-new-Shell)
-    *   [4.7 Why am I being injected with _null_?](#Why-am-I-being-injected-with-null)
-    *   [4.8 Why aren't my parts being injected with my value set from my bundle activator?](#Why-aren.27t-my-parts-being-injected-with-my-value-set-from-my-bundle-activator)
-    *   [4.9 What is the difference between IEclipseContext#set and IEclipseContext#modify?](#what-is-the-difference-between-ieclipsecontextset-and-ieclipsecontextmodify)
-    *   [4.10 Why aren't my _@EventTopic_ or _@UIEventTopic_ methods being called?](#why-arent-my-eventtopic-or-uieventtopic-methods-being-called)
-*   [5 Commands and Handlers](#Commands-and-Handlers)
-    *   [5.1 Why aren't my handler fields being re-injected?](#why-arent-my-handler-fields-being-re-injected)
-    *   [5.2 Why is my parameterized handler not triggered?](#Why-is-my-parameterized-handler-not-triggered)
-    *   [5.3 Why does org.eclipse.core.commands.Command's isEnabled() and getHandler() not work?](#why-does-orgeclipsecorecommandscommands-isenabled-and-gethandler-not-work)
-*   [6 UI](#UI)
-    *   [6.1 How do I enable Drag N Drop (DND) of parts?](#how-do-i-enable-drag-n-drop-dnd-of-parts)
-    *   [6.2 Why are my CSS theming not taking effect?](#Why-are-my-CSS-theming-not-taking-effect)
-    *   [6.3 Why is my part's selection never set as the active selection?](#why-is-my-parts-selection-never-set-as-the-active-selection)
-*   [7 Customizing and Controlling the Platform](#Customizing-and-Controlling-the-Platform)
-    *   [7.1 How do I provide my own prompt-to-save when closing a part?](#How-do-I-provide-my-own-prompt-to-save-when-closing-a-part)
 
 Adopting the Eclipse 4 Application Platform
 -------------------------------------------
@@ -233,7 +186,7 @@ Two approaches to help diagnose such problems:
 
 ### What services are available for injection?
 
-See the [list of provided services](https://github.com/eclipse-platform/eclipse.platform.ui/blob/master/docs/Eclipse4_RCP_EAS_List_of_All_Provided_Services.md)
+See the [list of provided services](Eclipse4_RCP_EAS_List_of_All_Provided_Services.md)
 
 ### How can I override a provided object?