proofreading en alex

Author: madeindjs

rails6/en/api_on_rails.adoc

@@ -1,6 +1,6 @@
 = API on Rails 6
 Alexandre Rousseau <contact@rousseau-alexandre.fr>
-v0.1, 2019-05-28
+v0.1, 2019-08-11
 :doctype: book
 :toc:
 :imagesdir: img
@@ -14,7 +14,7 @@ v0.1, 2019-05-28
 :author: Alexandre Rousseau
 :description: Learn best practice to build an API using Ruby on Rails 5
 :front-cover-image: image:cover.svg[]
-:revdate: 2019-05-28
+:revdate: 2019-08-11
 
 include::chapter00-before.adoc[]
 

rails6/en/chapter00-before.adoc

@@ -13,7 +13,7 @@ NOTE: This book is also available in the Molière language (It means french).
 
 My name is http://rousseau-alexandre.fr[Alexandre Rousseau] and I am a Rails developer with more than 4 years of experience (at the time of writing). I am currently a partner in a company (https://isignif.fr[iSignif]) where I build and maintain a SAAS product using Rails. I also contribute to the Ruby community by producing and maintaining some gems that you can consult on https://rubygems.org/profiles/madeindjs[my Rubygems.org profile]. Most of my projects are on GitHub so don’t http://github.com/madeindjs/[hesitate to follow me].
 
-All the source code of this book is available in https://asciidoctor.org/[Asciidoctor] format on https://github.com/madeindjs/api_on_rails[GitHub]. So don’t hesitate to https://github.com/madeindjs/api_on_rails/fork[forke] the project if you want to improve it or fix a mistake that I didn’t notice.
+All the source code of this book is available in https://asciidoctor.org/[Asciidoctor] format on https://github.com/madeindjs/api_on_rails[GitHub]. So feel free to https://github.com/madeindjs/api_on_rails/fork[forke] the project if you want to improve it or fix a mistake that I didn’t notice.
 
 == Copyright and license
 

rails6/en/chapter01-introduction.adoc

@@ -86,12 +86,10 @@ $ ruby -v
 
 Rails 6.0 requires the installation of version 2.5 or higher.
 
-I recommend using http://rvm.io/[Ruby Version Manager (RVM)] or http://rbenv.org/[rbenv] to install it.
+I recommend using http://rvm.io/[Ruby Version Manager (RVM)] or http://rbenv.org/[rbenv] to install it. We will use RVM in this tutorial but it doesn't matter which of these two options you use
 
 The principle of these tools is allowing you to install several versions of Ruby on the same machine, in an environment that is airtight to a possible version installed on your operating system and to be able to switch from one to the other easily.
 
-In this tutorial, we will use RVM but it doesn't matter which of these two options you use.
-
 To install RVM, go to https://rvm.io/ and install the GPG footnote key:[The GPG key allows you to verify the identity of the author of the sources you download.]. Once that's done:
 
 [source,bash]
@@ -107,7 +105,7 @@ Next it is time to install ruby:
 $ rvm install 2.6
 ----
 
-If everything went smooth, it is time to install the rest of the dependencies we will be using.
+Now it is time to install the rest of the dependencies we will be using.
 
 ==== Gems, Rails & Missing libraries
 
@@ -129,9 +127,7 @@ We then install the necessary gems and ignore documentation for each gem:
 
 [source,bash]
 ----
-$ printf 'gem: --no-document' >> ~/.gemrc
 $ gem install bundler
-$ gem install foreman
 $ gem install rails -v 6.0.0.rc1
 ----
 
@@ -147,7 +143,7 @@ Rails 6.0.0.rc1
 
 ==== Database
 
-I highly recommend you installing http://www.postgresql.org/[Postgresql] to manage your databases, but for simplicity we’ll be using http://www.sqlite.org/[SQlite]. If you are using Mac OS you should be ready to go, in case you are on Linux, don’t worry we have you covered:
+I highly recommend you installing http://www.postgresql.org/[Postgresql] to manage your databases. But here we’ll using http://www.sqlite.org/[SQlite] for simplicity . If you are using Mac OS you should be ready to go, in case you are on Linux, don’t worry we have you covered:
 
 [source,bash]
 ----
@@ -163,7 +159,7 @@ $ sudo yum install libxslt-devel libxml2-devel libsqlite3-devel
 
 == Initializing the project
 
-Initializing a Rails application must be pretty straightforward for you, if that is not the case, here is a super quick tutorial.
+Initializing a Rails application may be pretty straightforward for you. If that is not the case here is a super quick tutorial.
 
 There is the command:
 
@@ -176,30 +172,22 @@ $ rails new market_place_api --api
 
 NOTE: The `--api` option appeared in version 5 of Rails. It allows to limit the libraries and _Middleware_ included in the application. This also avoids generating HTML views when using Rails generators.
 
-As you may guess, the commands above will generate the bare bones of your Rails application. The next step is to add some `gems` we’ll be using to build the api.
+As you may guess, the commands above will generate the bare bones of your Rails application.
 
 == Versioning
 
-Remember that Git helps you track and maintain your code history. Keep in mind that the source code of the application is published on GitHub. You can follow the project on https://github.com/madeindjs/api_on_rails_6[GitHub]
+Remember that Git helps you track and maintain your code history. Keep in mind that the source code of the application is published on GitHub. You can follow the project on https://github.com/madeindjs/api_on_rails_6[GitHub].
 
-When you used the `rails new` command, Ruby on Rails initialized the Git directory for you. This means that you do not need to execute the `git init` command.
+Ruby on Rails initialized the Git directory for you when you used the `rails new` command. This means that you do not need to execute the `git init` command.
 
-However, it is necessary to configure the information of the author of _commits_. If you have not already done so, go to the directory and run the following commands:
+However it is necessary to configure the information of the author of _commits_. If you have not already done so, go to the directory and run the following commands:
 
 [source,bash]
 ----
 $ git config --global user.name "Type in your name"
 $ git config --global user.email "Type in your email"
 ----
 
-
-Rails already initialize the new project as a brand new Git repository. If you encounter some problem you can initialize project like this:
-
-[source,bash]
-----
-$ git init
-----
-
 Rails also provide a _.gitignore_ file to ignore some files that we don’t want to track. The default _.gitignore_ file should looks like the one shown below:
 
 ..gitignore