updated getting started section on taxeditor site

[taxeditor.git] / src / site / fml / troubleshooting.fml

diff --git a/src/site/fml/troubleshooting.fml b/src/site/fml/troubleshooting.fml
index bb2c26150a7d7ab3d590805748ca10c4b2ded0e1..adcd1c717a6a43885a0e66aa61d0f0639df56985 100644 (file)
--- a/src/site/fml/troubleshooting.fml
+++ b/src/site/fml/troubleshooting.fml
@@ -6,7 +6,7 @@
        toplink="true">
        <part id="general">
                <title>General</title>
-               <faq id="whats-foo">
+               <faq id="How_can_I_configure_logging_in_the_editor">
                        <question>How can I configure logging in the editor?</question>
                        <answer>
                                <p>To get log4j to read your own configuration when developing the editor or 
@@ -16,11 +16,46 @@
                                        (which is mostly the log4j.properties in cdmlib-commons as it will be the 
                                        first one it encounters).</p>
                                <p>Passing the following argument to the Virtual Machine however does the trick:</p>
-                               <source>-Dlog4j.configuration=file:///&lt;path to your personal\&gt;/log4j.properties</source>
+                               <source>-Dlog4j.configuration=file:///&lt;path to your personal&gt;/log4j.properties</source>
                                <p>If you run into trouble , you can debug log4j's startup sequence by passing 
                                        another argument to the VM.</p>
                                <source>-Dlog4j.debug</source>
                        </answer>
                </faq>
+               <faq id="taxeditor_projects_have_errors">
+                       <question>Some of the taxeditor projects have errors</question>
+                       <answer>
+                               <p>And the errors do look like the cdmlib dependecies can not be resolved, there are two possible solutions for this problem.</p>
+                               <ol>
+                                       <li><em>cdmlib-plugin</em> does not contain the cdmlib dependencies
+                                               <p>Please follow the instructions on <a href="./getting-started.html#Initializing_the_cdmlib_plugin">how to initialize the cdmlib-plugin</a></p>
+                                       </li>
+                                       <li>Your classpath is outdated
+                                               <p>Update your classpath by right-clicking any of the <em>taxeditor-*</em> projects and choose <em>PDE Tools -&gt; Update Classpath...</em>. Click &lt;Select All&gt; in the dialog and confirm.</p>
+                                       </li>
+                               </ol>
+                       </answer>
+               </faq>
+               <faq id="Launching_the_editor_from_eclipse_is_simply_not_working">
+                       <question>Launching the editor from eclipse is simply not working for me.</question>
+                       <answer>
+                               <p>This could be due to many reasons. Please have a look at the <a href="http://dev.e-taxonomy.eu/trac/wiki/TroubleshootingEditorLaunches">Troubleshooting Editor Launches</a> document on the developers wiki.</p>
+                       </answer>
+               </faq>
+               <faq id="No_application_id_has_been_found">
+                       <question>I get a "RuntimeException: No application id has been found." preceded by lots of "Missing required bundle" errors when launching my run/debug configuration</question>
+                       <answer>
+                               <p>Whenever you change something in the plguin dependency hirarchy, i.e. adding, (re)moving, or renaming a dependant plugin your run configuration does not know about that automatically. To solve this:</p>
+                               <ul>
+                                       <li>In eclipse, open the <em>Run Configurations</em> wizard</li>
+                                       <li>Choose the run configuration in question</li>
+                                       <li>Select the <em>Plug-ins</em> tab</li>
+                                       <li>Click <em>Deselect All</em> from the buttons on the right</li>
+                                       <li>Click <em>Add Required Plug-ins</em></li>
+                                       <li>Apply your changes</li>
+                               </ul>
+                               <p>The editor should launch again.</p>
+                       </answer>
+               </faq>
        </part>
 </faqs>