update title of install parent page and rename some install pages

5 files changed, 12 insertions, 10 deletions

diff --git a/docs/modules/install/nav.adoc b/docs/modules/install/nav.adoc
index afd431e0..6908b431 100644
--- a/docs/modules/install/nav.adoc
+++ b/docs/modules/install/nav.adoc
@@ -1,6 +1,6 @@
 * xref:index.adoc[]
 ** xref:supported-platforms.adoc[]
-** xref:gem.adoc[]
-** xref:linux.adoc[]
+** xref:ruby-packaging.adoc[]
+** xref:linux-packaging.adoc[]
 ** xref:macos.adoc[]
 ** xref:windows.adoc[]
diff --git a/docs/modules/install/pages/index.adoc b/docs/modules/install/pages/index.adoc
index bdc1c57d..67ecc0b0 100644
--- a/docs/modules/install/pages/index.adoc
+++ b/docs/modules/install/pages/index.adoc
@@ -1,4 +1,4 @@
-= Install Asciidoctor
+= Install and Update
 
 To simplify installation, Asciidoctor is packaged and distributed as a RubyGem (aka gem) to {url-rubygem}/asciidoctor[RubyGems.org^].
 It's also distributed as a package for popular Linux distributions and macOS.
@@ -15,3 +15,5 @@ Asciidoctor can be installed using:
 * Bundler.
 
 The benefit of using your operating system's package manager to install the gem is that it handles installing Ruby and the RubyGems library if those packages are not already installed on your machine.
+
+You should use the same method to update Asciidoctor as you use to install it.
diff --git a/docs/modules/install/pages/linux.adoc b/docs/modules/install/pages/linux-packaging.adoc
index a2b605f6..5df8c1f0 100644
--- a/docs/modules/install/pages/linux.adoc
+++ b/docs/modules/install/pages/linux-packaging.adoc
@@ -1,4 +1,4 @@
-= Install Using a Linux Package Manager
+= Install Using Linux Packaging
 :url-alpine: https://pkgs.alpinelinux.org/packages?name=asciidoctor
 :url-arch: https://www.archlinux.org/packages/?name=asciidoctor
 :url-debian: https://packages.debian.org/sid/asciidoctor
@@ -8,7 +8,7 @@
 
 The benefit of using your operating system's package manager to install the gem is that it handles installing Ruby and the RubyGems library if those packages are not already installed on your machine.
 
-== Linux packages
+== Package versions
 
 The version of Asciidoctor installed by the package manager may not match the latest release of Asciidoctor.
 Consult the package repository for your distribution to find out which version is packaged per distribution release.
@@ -20,7 +20,7 @@ Consult the package repository for your distribution to find out which version i
 * {url-suse}[OpenSUSE (rubygem-asciidoctor)]
 * {url-ubuntu}[Ubuntu (asciidoctor)]
 
-If you want to use a version of Asciidoctor that is newer than what is available via your package manager, see xref:gem.adoc[].
+If you want to use a version of Asciidoctor that is newer than what is available via your package manager, see xref:ruby-packaging.adoc[].
 
 == APT
 
@@ -60,7 +60,7 @@ include::partial$success.adoc[]
 == Upgrading on Linux
 
 Some Linux distributions may not have the latest stable version of Asciidoctor packaged immediately after a release of a new gem.
-If you need to upgrade to the latest version immediately, use xref:gem.adoc[gem install] instead of the package manager.
+If you need to upgrade to the latest version immediately, use xref:ruby-packaging.adoc[gem install] instead of the package manager.
 
 TIP: Your Linux system may be configured to automatically update packages, in which case the latest Asciidoctor package will be installed as soon as it becomes available.
 No further action is required by you.
diff --git a/docs/modules/install/pages/gem.adoc b/docs/modules/install/pages/ruby-packaging.adoc
index af8b116f..ea9e0994 100644
--- a/docs/modules/install/pages/gem.adoc
+++ b/docs/modules/install/pages/ruby-packaging.adoc
@@ -1,4 +1,4 @@
-= Install Using Ruby Tools
+= Install Using Ruby Packaging
 
 [#gem-install]
 == gem install
diff --git a/docs/modules/install/pages/windows.adoc b/docs/modules/install/pages/windows.adoc
index ae25d23e..2248b0b1 100644
--- a/docs/modules/install/pages/windows.adoc
+++ b/docs/modules/install/pages/windows.adoc
@@ -11,8 +11,8 @@ When you already use https://chocolatey.org[chocolatey^] on your machine, you ca
 choco install ruby
 ----
 
-Then follow the xref:gem.adoc[gem installation instructions].
+Then follow the xref:ruby-packaging.adoc[gem installation instructions].
 
 == Rubyinstaller
 
-Or you use the https://rubyinstaller.org/downloads/[Rubyinstaller^], download the package for your Windows Version and after the installation, then follow the xref:gem.adoc[gem installation instructions].
+Or you use the https://rubyinstaller.org/downloads/[Rubyinstaller^], download the package for your Windows Version and after the installation, then follow the xref:ruby-packaging.adoc[gem installation instructions].