diff --git a/source/docs/c-continuous-integration.md.erb b/source/docs/c-continuous-integration.md.erb
index b5c86805..62bec152 100644
--- a/source/docs/c-continuous-integration.md.erb
+++ b/source/docs/c-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/c.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using the Ubuntu 14.04 image and you want to switch to Ubuntu 18.04, be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
You can test and integrate C/C++ programs on Semaphore using the preinstalled
diff --git a/source/docs/clojure-continuous-integration.md.erb b/source/docs/clojure-continuous-integration.md.erb
index 37644d87..9887cf16 100644
--- a/source/docs/clojure-continuous-integration.md.erb
+++ b/source/docs/clojure-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/clojure.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using the Ubuntu 14.04 image and you want to switch to Ubuntu 18.04, be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore makes it easy to test Clojure projects with Leiningen and Java
diff --git a/source/docs/databases/cassandra.md.erb b/source/docs/databases/cassandra.md.erb
index a5840b89..06f0abb7 100644
--- a/source/docs/databases/cassandra.md.erb
+++ b/source/docs/databases/cassandra.md.erb
@@ -4,10 +4,10 @@ title: Cassandra
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore provides Cassandra version <%= package_version("cassandra") %> preinstalled.
diff --git a/source/docs/databases/memcached.md b/source/docs/databases/memcached.md
index 0ec04f00..a28e1736 100644
--- a/source/docs/databases/memcached.md
+++ b/source/docs/databases/memcached.md
@@ -4,10 +4,10 @@ title: Memcached
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Memcached is running on the default port 11211.
diff --git a/source/docs/databases/mongodb.md b/source/docs/databases/mongodb.md
index 2e650e73..2d9ed7fa 100644
--- a/source/docs/databases/mongodb.md
+++ b/source/docs/databases/mongodb.md
@@ -4,10 +4,10 @@ title: MongoDB
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
[MongoDB](https://www.mongodb.org/) doesn't provide a command to create a "database".
diff --git a/source/docs/databases/mysql.md b/source/docs/databases/mysql.md
index 0921a8ca..631e1813 100644
--- a/source/docs/databases/mysql.md
+++ b/source/docs/databases/mysql.md
@@ -4,10 +4,10 @@ title: MySQL
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Credentials for using MySQL are available in environment variables listed below:
diff --git a/source/docs/databases/postgis.md.erb b/source/docs/databases/postgis.md.erb
index 8598925e..6ee5cabd 100644
--- a/source/docs/databases/postgis.md.erb
+++ b/source/docs/databases/postgis.md.erb
@@ -4,10 +4,10 @@ title: PostGIS
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore provides PostGIS (spatial and geographic objects for PostgreSQL) version <%= package_version("postgis") %> out of the box.
diff --git a/source/docs/databases/postgresql.md.erb b/source/docs/databases/postgresql.md.erb
index f9531c8b..72e8ec2f 100644
--- a/source/docs/databases/postgresql.md.erb
+++ b/source/docs/databases/postgresql.md.erb
@@ -4,10 +4,10 @@ title: PostgreSQL
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore supports 2 versions of PostgreSQL:
diff --git a/source/docs/databases/redis.md b/source/docs/databases/redis.md
index 82897ad0..b5658ec0 100644
--- a/source/docs/databases/redis.md
+++ b/source/docs/databases/redis.md
@@ -4,10 +4,10 @@ title: Redis
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Redis is running on the default port 6379.
diff --git a/source/docs/databases/rethinkdb.md.erb b/source/docs/databases/rethinkdb.md.erb
index f22f8958..3ed855b0 100644
--- a/source/docs/databases/rethinkdb.md.erb
+++ b/source/docs/databases/rethinkdb.md.erb
@@ -4,10 +4,10 @@ title: RethinkDB
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore provides RethinkDB version <%= package_version("rethinkdb") %> out of the box.
diff --git a/source/docs/databases/sqlite.md b/source/docs/databases/sqlite.md
index a2225717..6078831e 100644
--- a/source/docs/databases/sqlite.md
+++ b/source/docs/databases/sqlite.md
@@ -4,10 +4,10 @@ title: SQLite
category: Databases
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
If you need to create a SQLite database manually, you can use the following
diff --git a/source/docs/elixir-continuous-integration.md.erb b/source/docs/elixir-continuous-integration.md.erb
index bdc51ec0..fea27e75 100644
--- a/source/docs/elixir-continuous-integration.md.erb
+++ b/source/docs/elixir-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/elixir.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore makes it easy to setup continuous integration for Elixir projects.
diff --git a/source/docs/erlang-continuous-integration.md.erb b/source/docs/erlang-continuous-integration.md.erb
index 91aa4f1e..d2077fd5 100644
--- a/source/docs/erlang-continuous-integration.md.erb
+++ b/source/docs/erlang-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/erlang.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore provides Erlang through [kerl](https://github.com/yrashk/kerl), which
diff --git a/source/docs/go-continuous-integration.md.erb b/source/docs/go-continuous-integration.md.erb
index 6dce75cd..e7822a45 100644
--- a/source/docs/go-continuous-integration.md.erb
+++ b/source/docs/go-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/go.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Setting up a Golang project on Semaphore is easy. The first time you add a Go
diff --git a/source/docs/java-continuous-integration.md.erb b/source/docs/java-continuous-integration.md.erb
index 9adb5826..7cdce335 100644
--- a/source/docs/java-continuous-integration.md.erb
+++ b/source/docs/java-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/java.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore supports the following Java versions:
diff --git a/source/docs/javascript-continuous-integration.md.erb b/source/docs/javascript-continuous-integration.md.erb
index 8bb871d9..4af3a444 100644
--- a/source/docs/javascript-continuous-integration.md.erb
+++ b/source/docs/javascript-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/javascript.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore makes it easy to test and deploy JavaScript and Node.js applications.
diff --git a/source/docs/php-continuous-integration.md.erb b/source/docs/php-continuous-integration.md.erb
index f4e62228..05253025 100644
--- a/source/docs/php-continuous-integration.md.erb
+++ b/source/docs/php-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/php.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Setting up a continuous integration process for PHP is easy on Semaphore, with
diff --git a/source/docs/platform-updates.md b/source/docs/platform-updates.md
index 3236e3a3..74b04cbf 100644
--- a/source/docs/platform-updates.md
+++ b/source/docs/platform-updates.md
@@ -3,10 +3,10 @@ layout: post
title: Platform updates
category: The Semaphore platform
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Each platform update is named with a YYMM pattern, for example the update for
diff --git a/source/docs/python-continuous-integration.md.erb b/source/docs/python-continuous-integration.md.erb
index a0d0b533..6b658c51 100644
--- a/source/docs/python-continuous-integration.md.erb
+++ b/source/docs/python-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/python.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore makes it easy to setup continuous integration for Python projects.
diff --git a/source/docs/ruby-continuous-integration.md.erb b/source/docs/ruby-continuous-integration.md.erb
index 98cecb7e..63f0b059 100644
--- a/source/docs/ruby-continuous-integration.md.erb
+++ b/source/docs/ruby-continuous-integration.md.erb
@@ -7,10 +7,10 @@ tags:
- ruby
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
You can set up continuous integration for Ruby projects on Semaphore in a snap.
diff --git a/source/docs/scala-continuous-integration.md.erb b/source/docs/scala-continuous-integration.md.erb
index 9aa5ec35..44ba6f34 100644
--- a/source/docs/scala-continuous-integration.md.erb
+++ b/source/docs/scala-continuous-integration.md.erb
@@ -5,10 +5,10 @@ alias: docs/scala.html
category: Languages
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Semaphore makes it easy to set up continuous integration for Scala projects.
diff --git a/source/docs/supported-stack.md.erb b/source/docs/supported-stack.md.erb
index 8bab9e7b..be9eced7 100644
--- a/source/docs/supported-stack.md.erb
+++ b/source/docs/supported-stack.md.erb
@@ -3,10 +3,10 @@ layout: post
title: Supported stack
category: The Semaphore platform
---
-This document contains information related to projects based on Ubuntu 14.04 image.
-If you are using Ubuntu 18.04 image for your projects please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
+This document contains information related to projects based on the Ubuntu 14.04 image.
+If you are using the Ubuntu 18.04 image for your projects, please refer to [this page](https://semaphoreci.com/docs/ubuntu-1804.html).
-If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-use-new-platform).
+If you are using Ubuntu 14.04 image and you want to switch to Ubuntu 18.04 be sure to check our [upgrade guide](https://semaphoreci.com/docs/ubuntu-1804.html#how-to-upgrade).
___
Every build and deployment on Semaphore runs in an isolated virtual machine, based on
diff --git a/source/docs/ubuntu-1804.md b/source/docs/ubuntu-1804.md
index a4dd236a..2ee073ec 100644
--- a/source/docs/ubuntu-1804.md
+++ b/source/docs/ubuntu-1804.md
@@ -32,7 +32,7 @@ The Ubuntu 18.04 platform uses an APT mirror that is in the same data center as
## How to upgrade
-### 1. Switch to new version of the platform
+### 1. Switch to the new version of the platform
- Visit **Project settings**.
- Click on **Platform** tab in Project settings.
@@ -41,49 +41,49 @@ The Ubuntu 18.04 platform uses an APT mirror that is in the same data center as
### 2. Select programming language version with sem-version CLI
-Versions are now configured with a built-in `sem-version` command. This new approach enables you to configure versions of different languages and also enables us to add new versions faster.
+Versions are now configured with a built-in `sem-version` command. This new approach enables you to configure versions of different languages and it also enables us to add new versions faster.
-With `sem-version` you can configure versions of the following programming languages: PHP, Ruby, Erlang, Go, Java, C/C++, Python, Elixir, Scala, Node.js. For information about available versions [check documentation](#supported-software-stack).
+With `sem-version` you can configure versions of the following programming languages: PHP, Ruby, Erlang, Go, Java, C/C++, Python, Elixir, Scala, Node.js. For information about available versions, [check documentation](#supported-software-stack).
-Example of commands that you can add to your job, or to setup commands that will be executed as a part of every job:
+Example of commands that you can add to your job, or to Setup commands that will be executed as a part of every job:
```bash
sem-version ruby 2.6.3
sem-version node 10.1
```
-For more information about using sem-version [check documentation](#sem-version).
+For more information about using sem-version, [check documentation](#sem-version).
### 3. Start databases with sem-service CLI
-Start only services that you need with the built-in `sem-service` command. Databases are no longer running by default so you can use desired versions and more resources are left for running your workloads.
+Start only services that you need with the built-in `sem-service` command. Databases are no longer running by default so you can use the desired versions and more resources are left for running your workloads.
-With `sem-service` you can start desired version of following databases and services: MySQL, PostgreSQL, Redis, memcached, MongoDB, ElasticSearch and RabbitMQ.
+With `sem-service` you can start the desired version of the following databases and services: MySQL, PostgreSQL, Redis, memcached, MongoDB, ElasticSearch and RabbitMQ.
Example of commands that you can add to your job, or to Setup commands that will be executed before every job:
```bash
sem-service start mysql
sem-service start rabbitmq
-sem-service start postgres 11.5
+sem-service start postgres 11
```
-For the list of all databases, services and available versions check [Ubuntu 18.04 platform documentation](#supported-software-stack).
+For the list of all databases, services and available versions, check the [Ubuntu 18.04 platform documentation](#supported-software-stack).
### 4. Install additional software
-If your application requires software packages that are not pre-installed be aware that versions available in Ubuntu 18.04 might differ. The best way to go about this is to check the [list of pre-installed packages](#supported-software-stack) before installing software manually.
+If your application requires software packages that are not pre-installed, be aware that versions available in Ubuntu 18.04 might differ. The best way to go about this is to check the [list of pre-installed packages](#supported-software-stack) before installing software manually.
Ubuntu 14.04 and Ubuntu 18.04 have mostly the same components with newer versions.
Notable changes:
-- Background services are now managed with **systemd** while in Ubuntu 14.04 it was managed by **init.d** and **upstart**.
+- Background services are now managed with **systemd**, while in Ubuntu 14.04 it was managed by **init.d** and **upstart**.
- AppArmor is started by default. It’s likely that this will not affect your application unless you are using KVM or QEMU.
### 5. Finally: Run your jobs as you used to.
## Programming languages
-The `sem-version` utility is used for changing the version of a programming language. You can find list of all available programming languages with available versions [here](#programming-languages).
+The `sem-version` utility is used for changing the version of a programming language. You can find a list of all available programming languages with available versions [here](#programming-languages).
The supported programming languages are Elixir, Erlang, Go, Java, PHP, Ruby, Python, Scala and Node.js.
The general form of the `sem-version` utility is:
@@ -92,8 +92,8 @@ The general form of the `sem-version` utility is:
sem-version [LANGUAGE] [VERSION]
```
-where [LANGUAGE] is one of `elixir, erlang, go, java, php, ruby, python, scala` and `node`. The value of the [VERSION] parameter depends on the programming language used.
-Example of sem-version in your job set up:
+where [LANGUAGE] is one of `elixir, erlang, go, java, php, ruby, python, scala` and `node`. The value of the [VERSION] parameter depends on the programming language used.
+Example of the sem-version in your job set up:
```bash
sem-version go 1.9
@@ -106,20 +106,21 @@ The `sem-service` is a utility for starting, stopping and getting the status of
The general form of a `sem-service` command is as follows:
```bash
-sem-service start [mysql | postgres | redis | memcached | mongodb | elasticsearch | rabbitmq | rethinkdb | cassandra] [version] [--username=username] [--password=password] [--db=databasename]
+sem-service start [mysql | postgres | postgis | redis | memcached | mongodb | elasticsearch | rabbitmq | rethinkdb | cassandra] [version] [--username=username] [--password=password] [--db=databasename]
```
Therefore, each `sem-service` command requires at least two parameters: the first one is the task you want to perform and the second parameter is the name of the service that will be used for the task. The third parameter is optional and is the version of the service that you want to start.
-For MySQL and PostgreSQL it is possible to provide username via `--username=username`, password for the new username via `--password=password` and database name for which the user will be granted admin access via `--db=dbname`.
+For MySQL, PostgreSQL and PostGIS it is possible to provide a username via `--username=username`, the password for the new username via `--password=password` and a database name for which the user will be granted admin access via `--db=dbname`.
-- The default MySQL username is `root`, the password is `semaphoredb` and the default database name is `test`
-- The default PostgreSQL username is `runner` and password is `semaphoredb`.
+- The default MySQL username is `root`, the password is `semaphoredb`.
+- The default PostgreSQL and PostGIS username is `runner` and the password is `semaphoredb`.
If no version value is given, a default value will be used according to the following list:
- mysql: The default value is `5.6`
- postgres: The default value is `9.6`
+- postgis: The default value is `9.6-2.5`, meaning postgis 2.5 and postgres 9.6
- redis: The default value is `4`
- memcached: The default value is `1.5`
- mongodb: The default value is `4.1`
@@ -133,6 +134,7 @@ If no version value is given, a default value will be used according to the foll
- ElasticSearch:
- MySQL:
- PostgreSQL:
+- PostGIS:
- Redis:
- MongoDB:
- Memcached:
@@ -147,6 +149,7 @@ sem-service start mysql
sem-service start postgres
sem-service start mysql 8.0.19 --username=demo --password=asdf --db=mydb
sem-service start postgres 11 --username=demo --password=asdf --db=mydb
+sem-service start postgis 12-3.0 --username=demo --password=asdf --db=mydb
sem-service start redis
sem-service start redis 5
sem-service start memcached
@@ -160,13 +163,13 @@ sem-service start mongodb 3.2
- **Rolling release**: - Ubuntu 18.04 platform will be automatically updated in small increments, meaning that users will always have the latest versions of software.
- **Schedule**: The image will be updated bi-weekly, on the first and third week of every month. Updates may happen sooner if there are any security updates or bug fixes that need to be implemented. For updates please check [changelng](#changelog)
-- **No action required**: Since rolling release process is used to update this image no action is required on user side. Newest version of software and services will be automatically available to users once the update happenes.
+- **No action required**: Since the rolling release process is used to update this image, no action is required on user side. The newest version of software and services will be automatically available to users once the update happenes.
## Supported software stack
### Version control
-Following version control tools are pre-installed:
+The following version control tools are pre-installed:
- Git (2.x)
- Git LFS (Git Large File Storage)
@@ -177,16 +180,16 @@ Following version control tools are pre-installed:
- Firefox 68.4.1
- geckodriver 0.26.0
-- Google Chrome 80
-- chrome_driver 80
-- xvfb (X Virtual Framebuffer)
-- phantomjs 2.1.1
+- Google Chrome 81
+- Chromedriver 81
+- Xvfb (X Virtual Framebuffer)
+- Phantomjs 2.1.1
Chrome and Firefox both support headless mode. You shouldn't need to do more than install and use the relevant Selenium library for your language. Refer to the documentation of associated libraries when configuring your project.
### Docker
-Docker toolset is installed and following versions are available:
+Docker toolset is installed and the following versions are available:
- Docker 19.03
- docker-compose 1.24.1
@@ -215,10 +218,10 @@ Docker toolset is installed and following versions are available:
- 2.1.0 to 2.1.10
- 2.2.0 to 2.2.10
- 2.3.0 to 2.3.8
-- 2.4.0 to 2.4.9
-- 2.5.0 to 2.5.7
-- 2.6.0 to 2.6.5
-- 2.7.0
+- 2.4.0 to 2.4.10
+- 2.5.0 to 2.5.8
+- 2.6.0 to 2.6.6
+- 2.7.0, 2.7.1
- jruby-9.1.17.0
#### JavaScript via Node.js
@@ -278,7 +281,7 @@ Installed versions:
Erlang versions are installed and managed via [kerl](https://github.com/kerl/kerl). Elixir versions are installed with [kiex](https://github.com/taylor/kiex).
-- Erlang: 20.3, 21.3, 22.2
+- Erlang: 20.3, 21.3, 22.3
- Elixir: 1.7.4, 1.8.0, 1.8.1, 1.8.2, 1.9.0, 1.9.1, 1.9.2, 1.9.3, 1.9.4
##### Additional libraries
@@ -290,8 +293,8 @@ Erlang versions are installed and managed via [kerl](https://github.com/kerl/ker
- 1.10.8
- 1.11.13
-- 1.12.10
-- 1.13.1
+- 1.12.17
+- 1.13.9
#### Java and JVM languages
@@ -307,6 +310,22 @@ Erlang versions are installed and managed via [kerl](https://github.com/kerl/ker
## Changelog
+### 13th April 2020
+
+- Additions:
+ - Wkhtmltox 0.15
+ - Ruby 2.4.10, 2.5.8, 2.6.6, 2.7.1
+- Updates
+ - Aws-cli 1.18.20 -> 1.18.39
+ - Git 2.25 -> 2.26
+ - Erlang 22.1 -> 22.3
+ - Go 1.12.10 -> 1.12.17
+ - Go 1.13.1 -> 1.13.8
+ - Heroku 7.39.0 -> 7.39.2
+ - Google Chrome 80 -> 81
+ - Chromedriver 80 -> 81
+
+
### 25th March 2020
Initial release.