diff --git a/docs/docs/contributing-started.mdx b/docs/docs/contributing-started.mdx
index 221c5a05f46e..8024ede3ba4a 100644
--- a/docs/docs/contributing-started.mdx
+++ b/docs/docs/contributing-started.mdx
@@ -115,7 +115,7 @@ A default config(.vscode folder) for [Visual Studio Code](https://code.visualstu
 - golangci-lint is configured as the default linter.
 - Recommended extensions available for a smooth bootstrap.
 
-  ![recommended extensions](recommended_extensions.png "Recommended extensions" )
+  ![recommended extensions](/img/recommended_extensions.png "Recommended extensions" )
 - Default run and debug configurations available.
 
 Once the extensions are installed:
diff --git a/docs/docs/segment-dotnet.md b/docs/docs/segment-dotnet.md
index b19c0f4f2531..ea6d03898efd 100644
--- a/docs/docs/segment-dotnet.md
+++ b/docs/docs/segment-dotnet.md
@@ -6,7 +6,7 @@ sidebar_label: Dotnet
 
 ## What
 
-Display the currently active .NET SDK version when a folder contains .NET files.
+Display the currently active .NET SDK version.
 
 ## Sample Configuration
 
@@ -29,7 +29,7 @@ Display the currently active .NET SDK version when a folder contains .NET files.
   is present - defaults to `true`
 - missing_command_text: `string` - text to display when the command is missing - defaults to empty
 - display_mode: `string` - determines when the segment is displayed
-  - `always`: The segment is always displayed
-  - `files`: The segment is only displayed when `*.cs`, `*.vb`, `*.sln`, `*.csproj`, or `*.vbproj` files are present (default)
+  - `always`: the segment is always displayed
+  - `files`: the segment is only displayed when `*.cs`, `*.vb`, `*.sln`, `*.csproj`, or `*.vbproj` files are present (default)
 - unsupported_version_icon: `string` - text/icon that is displayed when the active .NET SDK version (e.g., one specified
   by `global.json`) is not installed/supported - defaults to `\uf071` (X in a rectangle box)
diff --git a/docs/docs/segment-golang.md b/docs/docs/segment-golang.md
index f9b4f50c4857..13e21d0a02eb 100644
--- a/docs/docs/segment-golang.md
+++ b/docs/docs/segment-golang.md
@@ -6,7 +6,7 @@ sidebar_label: Golang
 
 ## What
 
-Display the currently active golang version when a folder contains golang files.
+Display the currently active golang version.
 
 ## Sample Configuration
 
@@ -28,5 +28,5 @@ Display the currently active golang version when a folder contains golang files.
 - display_version: `boolean` - display the golang version - defaults to `true`
 - missing_command_text: `string` - text to display when the command is missing - defaults to empty
 - display_mode: `string` - determines when the segment is displayed
-  - `always`: The segment is always displayed
-  - `files`: The segment is only displayed when `*.go` or `go.mod` files are present (default)
+  - `always`: the segment is always displayed
+  - `files`: the segment is only displayed when `*.go` or `go.mod` files are present (default)
diff --git a/docs/docs/segment-julia.md b/docs/docs/segment-julia.md
index a9d187c41fb7..f6b5fb8de3fa 100644
--- a/docs/docs/segment-julia.md
+++ b/docs/docs/segment-julia.md
@@ -6,7 +6,7 @@ sidebar_label: Julia
 
 ## What
 
-Display the currently active julia version when a folder contains julia files.
+Display the currently active julia version.
 
 ## Sample Configuration
 
@@ -28,5 +28,5 @@ Display the currently active julia version when a folder contains julia files.
 - display_version: `boolean` - display the julia version - defaults to `true`
 - missing_command_text: `string` - text to display when the command is missing - defaults to empty
 - display_mode: `string` - determines when the segment is displayed
-  - `always`: The segment is always displayed
-  - `files`: The segment is only displayed when `*.jl` files are present (default)
+  - `always`: the segment is always displayed
+  - `files`: the segment is only displayed when `*.jl` files are present (default)
diff --git a/docs/docs/segment-node.md b/docs/docs/segment-node.md
index b2d77567630c..0ca463208272 100644
--- a/docs/docs/segment-node.md
+++ b/docs/docs/segment-node.md
@@ -6,7 +6,7 @@ sidebar_label: Node
 
 ## What
 
-Display the currently active node version when a folder contains node files.
+Display the currently active node version.
 
 ## Sample Configuration
 
diff --git a/docs/docs/segment-python.md b/docs/docs/segment-python.md
index f09244d9dc48..63c2ebb82dea 100644
--- a/docs/docs/segment-python.md
+++ b/docs/docs/segment-python.md
@@ -32,8 +32,8 @@ or not - defaults to `true`
 - display_version: `boolean` - display the python version - defaults to `true`
 - missing_command_text: `string` - text to display when the command is missing - defaults to empty
 - display_mode: `string` - determines when the segment is displayed
-  - `always`: The segment is always displayed
-  - `files`: The segment is only displayed when `*.py`, `*.ipynb`, `pyproject.toml`, `venv.bak`, `venv`, or `.venv`
+  - `always`: the segment is always displayed
+  - `files`: the segment is only displayed when `*.py`, `*.ipynb`, `pyproject.toml`, `venv.bak`, `venv`, or `.venv`
     files are present (default)
-  - `environment`: The segment is only displayed when a virtual env is present
-  - `context`: The segment is only displayed when either `environment` or `files` is active
+  - `environment`: the segment is only displayed when a virtual env is present
+  - `context`: the segment is only displayed when either `environment` or `files` is active
diff --git a/docs/docs/recommended_extensions.png b/docs/static/img/recommended_extensions.png
similarity index 100%
rename from docs/docs/recommended_extensions.png
rename to docs/static/img/recommended_extensions.png