diff --git a/CHANGELOG.md b/CHANGELOG.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,3 +16,7 @@
 ## 0.3.1.0 -- 2020-03-06
 
 * Third version revised A. Fixed issues with not being compiled because of the ambiguous variables and wrong function application.
+
+## 0.3.1.1 -- 2020-03-06
+
+* Third version revised B. Some documentation improvements for README.markdown file.
diff --git a/README.markdown b/README.markdown
--- a/README.markdown
+++ b/README.markdown
@@ -11,12 +11,12 @@
 
 dobutokO2 {1 | 2} {name-of-the-file-to-be-recorded-to-obtain-sound-information-from-without-file-extension} {Ukrainian text}
 
-The first command line argument equals to 1 means that the executable
-will use the oberTones funcions, so for the given parameters the obertones
+If the first command line argument equals to "1" then the executable
+uses the oberTones funcions, so for the given parameters the obertones
 are the same for every call. Otherwise, it uses uniqOberTones functions, which
-can have different obertones because of the input additional text. The last one
-is used to generate the obertones. In such a case, another text gives the
-other obertones.
+can have different obertones because of the provided the second, additional,
+text. The last one is used to generate the obertones. In such a case, another
+text gives the other obertones.
 
 After the program executing (it takes some time) there is a file "end.wav" in the directory.
 This is the resulting melody generated.
@@ -24,11 +24,11 @@
 The program now lifts the frequencies to the octave with the number, which you
 can specify during its execution.
 
-You can specify some controlling parameters during the program execution. This
+You can specify some control parameters during the program execution. This
 leads to different sounding.
 
 You can use the default values (backward compatible with the 0.2.0.0 version)
-by simply pressing Enter while being prompted and the informational message
+by simply pressing 'Enter' while being prompted and the informational message
 contains the line about the default value.
 
 ** Note:
diff --git a/dobutokO2.cabal b/dobutokO2.cabal
--- a/dobutokO2.cabal
+++ b/dobutokO2.cabal
@@ -2,7 +2,7 @@
 -- documentation, see http://haskell.org/cabal/users-guide/
 
 name:                dobutokO2
-version:             0.3.1.0
+version:             0.3.1.1
 synopsis:            A program and a library to create experimental music from a mono audio and a Ukrainian text
 description:         It can also create a timbre for the notes
 homepage:            https://hackage.haskell.org/package/dobutokO2