Merge pull request rails#52251 from rails/fxn/edits

Edits in the dev containers guide

Author: fxn

guides/source/getting_started_with_devcontainer.md

@@ -3,20 +3,20 @@
 Getting Started with Dev Containers
 ===================================
 
-After reading this guide, you know:
+After reading this guide, you will know:
 
-* How to create a new Rails application with the `rails-new` tool
-* How to begin working with your application in a Dev Container
+* How to create a new Rails application with the `rails-new` tool.
+* How to begin working with your application in a development container.
 
 --------------------------------------------------------------------------------
 
 The best way to read this guide is to follow it step by step. All steps are
 essential to run this example application and no additional code or steps are
 needed.
 
-This guide helps you get set up with [Developer Containers (or Dev Containers for short)](https://containers.dev/)
-for a full-featured development environment. Dev Containers are used to run your
-Rails application in a container, without needing to install Rails or its dependencies
+This guide helps you get set up with [development containers (or dev containers for short)](https://containers.dev/)
+for a full-featured development environment. Dev containers are used to run your
+Rails application in a container, without needing to install Ruby or Rails or its dependencies
 directly on your machine. This is the fastest way to get your Rails application up and running.
 
 This is an alternative to installing Ruby and Rails directly on your machine, which is
@@ -27,38 +27,38 @@ the Getting Started guide.
 Setup and Installation
 ----------------------
 
-To get set up, you will need to install the relevant tools; Docker, VSCode and
-`rails-new`. We'll go into detail about each one below.
+To get set up, you will need to install the relevant tools; Docker, VS Code and
+`rails-new`. We'll go into details about each one below.
 
 ### Installing Docker
 
-Dev Containers are run using Docker, an open platform for developing, shipping, and
+Dev containers are run using Docker, an open platform for developing, shipping, and
 running applications. You can install Docker by following the installation instructions
 for your operating system in the [Docker docs](https://docs.docker.com/desktop/).
 
-Once Docker has been installed, launch the Docker Application to begin running
+Once Docker has been installed, launch the Docker application to begin running
 the Docker engine on your machine.
 
-### Installing VSCode
+### Installing VS Code
 
-Visual Studio Code (VSCode) is an open source code editor developed by Microsoft. VSCode's Dev Container
+Visual Studio Code (VS Code) is an open source code editor developed by Microsoft. VS Code's Dev Containers
 extension allows you to open any folder inside (or mounted into) a container and take advantage of
 Visual Studio Code's full feature set. A [devcontainer.json](https://code.visualstudio.com/docs/devcontainers/containers#_create-a-devcontainerjson-file)
 file in your project tells VS Code how to access (or create) a development container with a
 well-defined tool and runtime stack. It allows you to quickly spin up containers, access terminal
 commands, debug code, and utilize extensions.
 
-You can install VSCode by downloading it from [the website](https://code.visualstudio.com/).
+You can install VS Code by downloading it from [the website](https://code.visualstudio.com/).
 
-You can install the Dev Container extension by downloading it from [the marketplace](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers).
+You can install the Dev Containers extension by downloading it from [the marketplace](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers).
 
 ### Installing rails-new
 
 `rails-new` generates a new Rails application for you without having to install Ruby on
 your machine. It uses Docker to generate the Rails application, thus allowing Docker to
 take care of installing the correct Ruby and Rails versions for you.
 
-To install rails-new, follow the installation instructions [in the readme](https://github.com/rails/rails-new?tab=readme-ov-file#installation).
+To install `rails-new`, follow the installation instructions [in the README](https://github.com/rails/rails-new?tab=readme-ov-file#installation).
 
 Creating the Blog Application
 -----------------------------
@@ -99,25 +99,25 @@ see the full [Getting Started guide](getting_started.html#creating-the-blog-appl
 Opening the Blog Application in a Dev Container
 -----------------------------------------------
 
-Our new Rails application comes with a Dev Container already configured and ready to use.
-We will use VSCode to spin up and work with our Dev Container. Start by launching VSCode
+Our new Rails application comes with a dev container already configured and ready to use.
+We will use VS Code to spin up and work with our dev container. Start by launching VS Code
 and opening your application.
 
-Once the application opens, VSCode should prompt you that a it has found a Dev Container
-configuration file, and you can reopen the folder in a Dev Container. Click the green "Reopen
-in Container" button to create the Dev Container.
+Once the application opens, VS Code should prompt you that a it has found a dev container
+configuration file, and you can reopen the folder in a dev container. Click the green "Reopen
+in Container" button to create the dev container.
 
-Once the Dev Container setup is complete, your development environment is ready to use,
+Once the dev container setup is complete, your development environment is ready to use,
 with Ruby, Rails, and all your dependencies installed.
 
-You can open the terminal within VScode to verify that Rails is installed:
+You can open the terminal within VS Code to verify that Rails is installed:
 
 ```bash
 $ rails --version
 Rails 8.0.0
 ```
 
 You can now continue with the [Getting Started guide](getting_started.html#hello-rails) and
-begin building your Blog application. You will be working within VSCode, which serves as
-your entry point to your application's Dev Container, where you can run code, run tests and
+begin building your Blog application. You will be working within VS Code, which serves as
+your entry point to your application's dev container, where you can run code, run tests, and
 run your application.