diff --git a/HACKERS_README b/HACKERS_README
old mode 100644
new mode 100755
index 0015031c..e339499a
--- a/HACKERS_README
+++ b/HACKERS_README
@@ -1,3 +1,5 @@
+cat << eof
+
 Hey hackers,
 
 cdist has not been published, you're accessing a early in developent
@@ -11,6 +13,10 @@ Do not believe anything written in cdist, besides what's written in this file
 
 What you can do so far: (executed from top level directory)
 
+The following code will get executed if you run this README:
+
+eof
+
 # prepare use:
 export PATH="$PATH:$(pwd -P)/bin"
 object_tmp=/tmp/localhost/objects
diff --git a/doc/man/cdist-stages.text b/doc/man/cdist-stages.text
index fc43d7da..4a77f7b1 100644
--- a/doc/man/cdist-stages.text
+++ b/doc/man/cdist-stages.text
@@ -50,7 +50,7 @@ cdist passes through different stages:
    objects try to create the same object, which indicates a
    broken configuration.
 
-- Third stage: Code generation [TODO]
+- Fourth stage: Code generation [TODO]
    The "gencode" binary of the types for every existing object is
    called to generate code that will be executed on the target host.
 
@@ -62,7 +62,7 @@ cdist passes through different stages:
    A description of what the generated code may/must/should
    do can be found in cdist-types-gencode(7).
 
-- Fourth stage: [TODO]
+- Fifth stage: [TODO]
    The resulting code is transferred to the target host and executed,
    the run of cdist-deploy-to(1) ends.