--- a/README.md
+++ b/README.md
@@ -1,19 +1,108 @@
-# Taverna2Archi OSGi Bundle
+# Taverna-Provenance-Extractor v1.0
 
-Link to the official website: http://www.ifs.tuwien.ac.at/dp/process/projects/tavernaExtractor.html
+Link to the official website: ``http://www.ifs.tuwien.ac.at/dp/process/projects/tavernaExtractor.html``
 
-This OSGi bundle encapsulates following feature: Converts a Taverna 2.4/2.5 worfklow to an Archimate model regarding specification 2.1.
+Link to the repository ``https://opensourceprojects.eu/p/timbus/context-population/extractors/taverna-extractor``
 
-## RUNTIME DEPENDENCIES
+This program comes in two flavors:
+
+* Standalone CLI
+* OSGi Bundle
+
+## USING THE STANDALONE CLI 
+
+The standalone CLI version encapsulates two different features:
+
+* Feature A: Converts a Taverna 2.4 worfklow to an Archimate model.
+* Feature B: Accesses provenance data captured during a Taverna 2.4 workflow run, 
+	applies DROID on that capturing (to identify used file formats in the workflow) and generates 
+	a CSV report (including e.g., file formats). Extends an existing Domain Specific Ontology (DSO) 
+	with file format information identified by DROID.
+
+### Interacting with the standalone CLI version
+
+	A	=>	-i,--inputFile <arg>      ...specifies the taverna t2flow (input) file. \path\to\taverna\input.t2flow
+			-o,--outputFile <arg>     ...specifies the archimate (output) file. \path\to\archimate\output.archimate
+			 
+		   
+	B1	=>	-d,--droid <arg>       ...\path\where\to\save\droidOutputFile	
+	   		
+	B2	=>	-cr,--report <arg> 	    ...\path\where\droidOutputFile\is\located      								
+		    
+	B3	=>	-ont,--ontology-file <arg>  ...ontology to extend. \path\to\ontology
+			-r,--reportFile <arg>	    ...generated DROID CSV report.
+
+	(general)	-v, verbose		...enable verbose mode
+		   
+### Sample usage
+
+[A] Convert a Taverna Workflow to an Archimate Model:
+
+	java -jar TavernaExtractor.jar -i \path\to\TavernvaWorkflowInputFile.t2flow -o \path\to\ArchimateOutputFile.archimate 
+	
+[B] Extract including file formats from Workflow and identify them with DROID. In the following the 3 necessray steps are presented:
+    ATTENTION: Due to its DROID dependencies, make sure you are executing the TavernaExtractor.jar in the respective directory!!
+
+[B1] Running DROID identififaction on collected Taverna Workflow Run data:
+     INPUT: path to file which gets created.
+     OUTPUT: file containing DROID identification information in a none readable form.
+
+	java -jar TavernaExtractor.jar -d path\to\myDroidFile.droid
+	
+	Sample Output:
+	===== [ID] | [Workflow Name (Timestamp)] ===== | 2 entries found.
+
+	[1] MusicClassificationExperiment (2013-09-25 13:11:42.488)
+	[2] MusicClassificationExperiment (2013-09-23 10:44:43.839)
+	Your choice:  //Enter an ID to process
+	
+[B2] Generate a CSV report out of a DROID profile: (CSV report is stored in the same directory as the *.droid input file)
+     INPUT: file from step [B1].
+     OUTPUT: file in CSV format containing DROID information in a readable form.
+     
+	java -jar TavernaExtractor.jar -cr path\to\myDroidFile.droid
+	
+[B3] Extend existing ontology with information about the used file formats in the workflow run:
+     INPUT1: existing OWL file, which should be extended.
+     INPUT2: file from step [B2].
+     OUTPUT: updates OWL file from INPUT1.
+     
+	java -jar TavernaExtractor.jar -ont \path\to\myOntology.owl -r \path\to\myDroidCSVreportFile.droid.csv
+	
+### Build and Execution
+
+1. Clone the current project from ``https://opensourceprojects.eu/p/timbus/context-population/extractors/taverna-extractor``.
+2. Change in the checked-out directory.
+3. Adapt the ``TavernaExtractor.properties`` file.
+4. Use maven (``mvn package -DskipTests=true -Pstandalone``) to package the program. 
+5. Change to the 'target' directory.
+6. Run the executable with ``'java -jar TavernaExtractor.jar <args>'``.
+
+### Runtime Dependencies
 
 * JRE 1.7+
 * Apache Ant 1.9+ for building
-* DOT (comes with Graphviz). Is not mandatory
+* DOT (comes with Graphviz)
+	
+## USING THE OSGi TIMBUS testbed BUNDLE 
 
-## MANADATORY PARAMETERS
+The OSGi bundle can be accessed at ``http://testbed.timbusproject.net:3001/``
 
-* Path to the Taverna workflow input file (*.t2flow)
-* Path to the generated output file (*.generated.archimate)
+It encapsulates following feature: Converts a Taverna 2.4/2.5 worfklow to an Archimate model regarding specification 2.1.
+
+### Mandatory Parameters
+
+* fqdn ... IP of the remote address (e.g. ``134.191.240.68``)
+* port ... Port of the remote machine (e.g. ``10026``)
+* user ... Username Credentials (e.g. ``timbus``)
+* password ... Password Credentials (e.g. ``timbus``)
+* inputFileName ... Path to the Taverna workflow input file (e.g. ``/home/timbus/Documents/imagemagick_wf.t2flow``)
+* archimateOutputPath ... Path to the generated output file (e.g. ``/home/timbus/Documents/imagemagick.contextmodel.archimate``)
+* tavernaHome ... Path to Taverna Home directory (e.g. ``/home/timbus/.taverna-2.4.0``)
+ 
+### Build
+ 
+The bundle can also be build using maven ``mvn package -DskipTests=true -POSGi``
 		
 ## SUPPORTED TAVERNA ACTIVITIES