diff --git a/codeGenerator/samples/AUTOSAR/readMe.adoc b/codeGenerator/samples/AUTOSAR/readMe.adoc
index 76e63b3..2095517 100644
--- a/codeGenerator/samples/AUTOSAR/readMe.adoc
+++ b/codeGenerator/samples/AUTOSAR/readMe.adoc
@@ -9,7 +9,7 @@ application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-link:codeGenerator\doc\installation.txt[../../doc/installation.html^],
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
 too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
diff --git a/codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.txt b/codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.adoc
similarity index 96%
rename from codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.txt
rename to codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.adoc
index a578b38..343cc30 100644
--- a/codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.txt
+++ b/codeGenerator/samples/EmbeddedCoderAPIWithBusStruct/readMe.adoc
@@ -67,7 +67,7 @@ The DBC file used in this sample is the same as in the same integrations
 of comFramework's CAN interface. Hence, the specification of the
 functionality of the Simulink model can be found in form of the hand coded
 APSW in the sample integration of the CAN interface. See
-http://svn.code.sf.net/p/comframe/code/canInterface/trunk/sampleIntegrations/winSampleIntegration/code/APSW.
+link:../../../canInterface/sampleIntegrations/winSampleIntegration/code/APSW/pwr_computeEnginePower.c[canInterface/sampleIntegrations/winSampleIntegration/code/APSW/pwr_computeEnginePower.c^]
 
 Note, the pack and unpack functions as essential part of the code generation
 process are not included in the demo application. This sample focuses on
@@ -112,8 +112,8 @@ try. Note, C99 compliance is a must.
 
 To build and execute the demo application type:
 
-cd compileIt
-make run
+  cd compileIt
+  make run
 
 The demo application can be debugged using the script gdb.ps1. The GNU
 debugger needs to be on the system search path.
diff --git a/codeGenerator/samples/iterations/readMe.txt b/codeGenerator/samples/iterations/readMe.adoc
similarity index 91%
rename from codeGenerator/samples/iterations/readMe.txt
rename to codeGenerator/samples/iterations/readMe.adoc
index dd8655f..6e1583d 100644
--- a/codeGenerator/samples/iterations/readMe.txt
+++ b/codeGenerator/samples/iterations/readMe.adoc
@@ -11,7 +11,8 @@ installation test of the application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-codeGenerator\doc\installation.txt, too.
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
+too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
 straightforward.
diff --git a/codeGenerator/samples/mapCanIdToFrameIdx/readMe.txt b/codeGenerator/samples/mapCanIdToFrameIdx/readMe.adoc
similarity index 97%
rename from codeGenerator/samples/mapCanIdToFrameIdx/readMe.txt
rename to codeGenerator/samples/mapCanIdToFrameIdx/readMe.adoc
index 01c50f6..e460f08 100644
--- a/codeGenerator/samples/mapCanIdToFrameIdx/readMe.txt
+++ b/codeGenerator/samples/mapCanIdToFrameIdx/readMe.adoc
@@ -45,7 +45,8 @@ application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-codeGenerator\doc\installation.txt, too.
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
+too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
 straightforward.
diff --git a/codeGenerator/samples/raceTechnology/readMe.txt b/codeGenerator/samples/raceTechnology/readMe.adoc
similarity index 90%
rename from codeGenerator/samples/raceTechnology/readMe.txt
rename to codeGenerator/samples/raceTechnology/readMe.adoc
index 10a631c..033ba0d 100644
--- a/codeGenerator/samples/raceTechnology/readMe.txt
+++ b/codeGenerator/samples/raceTechnology/readMe.adoc
@@ -11,7 +11,8 @@ application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-codeGenerator\doc\installation.txt, too.
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
+too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
 straightforward.
diff --git a/codeGenerator/samples/scratchPad/readMe.txt b/codeGenerator/samples/scratchPad/readMe.adoc
similarity index 90%
rename from codeGenerator/samples/scratchPad/readMe.txt
rename to codeGenerator/samples/scratchPad/readMe.adoc
index fffb519..fbeb79a 100644
--- a/codeGenerator/samples/scratchPad/readMe.txt
+++ b/codeGenerator/samples/scratchPad/readMe.adoc
@@ -10,7 +10,8 @@ application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-codeGenerator\doc\installation.txt, too.
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
+too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
 straightforward.
diff --git a/codeGenerator/samples/stringCompare/readMe.txt b/codeGenerator/samples/stringCompare/readMe.adoc
similarity index 90%
rename from codeGenerator/samples/stringCompare/readMe.txt
rename to codeGenerator/samples/stringCompare/readMe.adoc
index 711d9f2..4857896 100644
--- a/codeGenerator/samples/stringCompare/readMe.txt
+++ b/codeGenerator/samples/stringCompare/readMe.adoc
@@ -10,7 +10,8 @@ application.
 If you want to run the application from another working folder then you
 will have to modify the script: The Windows script references the required
 resources by relative paths from here. Please, refer to
-codeGenerator\doc\installation.txt, too.
+link:../../doc/installation.html[codeGenerator\doc\installation.txt^],
+too.
 
 All Windows scripts are trivial; porting them to Linux or Mac OS is
 straightforward.