/* Cloning the repository */ Adding instructions

sbliven · andreasprlic · commit c70490038675 · 2016-04-09T10:59:47.000-07:00
diff --git a/_wikis/BioJava3_eclipse.md b/_wikis/BioJava3_eclipse.md
@@ -30,7 +30,61 @@ for the repository URL. If you don't want to make a fork (for instance,
 if you don't plan to make any changes), you can follow the instructions
 below exactly.
 
-*TODO: write instructions*
+Option 1: *Try these instructions first. If they don't work, try option
+2.*
+
+1.  Go to
+2.  In the Maven category, select 'Check out Maven Projects from SCM'
+    and click Next.
+3.  Select 'git' in the dropdown box. If 'git' is not an option, make
+    sure you have the m2e-egit connector installed as descripted below.
+4.  Add the URL for your biojava repository on github. For instance, to
+    checkout the main repository, use
+        https://github.com/biojava/biojava.git
+
+    Make sure that 'Checkout All Projects' is selected and click Finish.
+
+Option 2: *These instructions are more difficult, but may work if Option
+1 fails.*
+
+1.  Open the Git Repository View
+    1.  Go to
+    2.  Under 'Git', select 'Git Repositories'
+
+2.  Clone your git repository. The following is the easiest way to do
+    this from within Eclipse, but you could also get a local clone via
+    the command line and then add it as a local repository.
+    1.  Click the 'Clone Git Repository' icon in the Git Repository View
+    2.  Add the URL of your biojava repository on github. For instance,
+        to checkout the main repository, use
+            https://github.com/biojava/biojava.git
+
+    3.  Optionally add your Github username and password, then click
+        Next.
+    4.  Select which branches to include. If you plan to commit any
+        changes, we recommend only tracking the 'devel' branch, so you
+        don't accidentally initiate a release. If you want the last
+        stable version, you can select 'release' instead. Click Next.
+    5.  Choose a destination directory (outside your Eclipse workspace),
+        double-check your selection of Initial branch, and click Finish
+
+3.  Import Maven projects from the git repository.
+    1.  Right click on the biojava git repository in the Git
+        Repositories viewer. Select 'Import Maven Projects...'
+    2.  Select all modules and click Finish
+
+4.  Initiate git tracking for the projects
+    1.  Select all biojava modules in the Project Explorer
+    2.  Right click and select
+    3.  Select 'Git' and click Next
+    4.  Select 'Use or create repository in parent folder of project'.
+        This will use the local repository you cloned previously for
+        your source code
+    5.  Finished!
+
+You should now have source to all the biojava modules (biojava3-core,
+biojava3-structure, etc). Viewing the history for any file should show
+you all commits since 2009 which have contributed to that file.
 
 Plugin Installation
 -------------------
diff --git a/_wikis/BioJava3_eclipse.mediawiki b/_wikis/BioJava3_eclipse.mediawiki
@@ -12,7 +12,37 @@ Eclipse is a common IDE for using BioJava.
 
 We recommend [[Contributing to BioJava#Forking Biojava|creating a fork]] on github for day-to-day development. In the following instructions you should substitute something like 'https://github.com/<username>/biojava.git' for the repository URL. If you don't want to make a fork (for instance, if you don't plan to make any changes), you can follow the instructions below exactly.
 
-''TODO: write instructions''
+Option 1:
+''Try these instructions first. If they don't work, try option 2.''
+<!-- These instructions should work and are simple, but don't work for me on ubuntu. They fail with 'No Maven projects found'~~~~ -->
+# Go to {{menu2|File|Import...}}
+# In the Maven category, select 'Check out Maven Projects from SCM' and click Next.
+# Select 'git' in the dropdown box. If 'git' is not an option, make sure you have the m2e-egit connector installed as descripted below.
+# Add the URL for your biojava repository on github. For instance, to checkout the main repository, use <pre>https://github.com/biojava/biojava.git</pre>Make sure that 'Checkout All Projects' is selected and click Finish.
+
+Option 2:
+''These instructions are more difficult, but may work if Option 1 fails.''
+
+# Open the Git Repository View
+## Go to {{menu3|Window|Show View|Other...}}
+## Under 'Git', select 'Git Repositories'
+# Clone your git repository. The following is the easiest way to do this from within Eclipse, but you could also get a local clone via the command line and then add it as a local repository.
+## Click the 'Clone Git Repository' icon in the Git Repository View
+## Add the URL of your biojava repository on github. For instance, to checkout the main repository, use <pre>https://github.com/biojava/biojava.git</pre>
+## Optionally add your Github username and password, then click Next.
+## Select which branches to include. If you plan to commit any changes, we recommend only tracking the 'devel' branch, so you don't accidentally initiate a release. If you want the last stable version, you can select 'release' instead. Click Next.
+## Choose a destination directory (outside your Eclipse workspace), double-check your selection of Initial branch, and click Finish
+# Import Maven projects from the git repository.
+## Right click on the biojava git repository in the Git Repositories viewer. Select 'Import Maven Projects...'
+## Select all modules and click Finish
+# Initiate git tracking for the projects
+## Select all biojava modules in the Project Explorer
+## Right click and select {{menu2|Team|Share Project...}}
+## Select 'Git' and click Next
+## Select 'Use or create repository in parent folder of project'. This will use the local repository you cloned previously for your source code
+## Finished!
+
+You should now have source to all the biojava modules (biojava3-core, biojava3-structure, etc). Viewing the history for any file should show you all commits since 2009 which have contributed to that file.
 
 == Plugin Installation ==
 
