Skip to content

Commit c930453

Browse files
scooleyscooley
authored
Updated docs with SEO changes (#142)
* fixed links * removed caveats * links * code block * added ms.author * missing metadata
1 parent a48a914 commit c930453

11 files changed

Lines changed: 38 additions & 22 deletions

‎commandline/WSL/about.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Learn about the Windows Subsystem for Linux
33
description: Learn more about how the Windows Subsystem for Linux works.
44
keywords: BashOnWindows, bash, wsl, windows, windowssubsystem
55
author: scooley
6+
ms.author: scooley
67
ms.date: 7/11/2016
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/faq.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Frequently Asked Questions (FAQ)
33
description: Frequently Asked Questions about the Windows Subsystem for Linux.
44
keywords: BashOnWindows, bash, wsl, windows, windowssubsystem
55
author: scooley
6+
ms.author: scooley
67
ms.date: 7/31/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/install-on-server.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Install the Linux Subsystem on Windows Server
33
description: Installation instructions for the Linux Subsystem on Windows Server.
44
keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu, windows server
55
author: scooley
6+
ms.author: scooley
67
ms.date: 11/15/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/install-win10.md‎

Lines changed: 9 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Install the Linux Subsystem on Windows 10
33
description: Installation instructions for the Linux Subsystem on Windows 10.
44
keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu, windows 10
55
author: scooley
6+
ms.author: scooley
67
ms.date: 7/11/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux
@@ -12,15 +13,6 @@ ms.assetid: 7afaeacf-435a-4e58-bff0-a9f0d75b8a51
1213

1314
# Windows 10 Installation Guide
1415

15-
## Prerequisites
16-
Your PC must be running a 64-bit version of Windows 10 Anniversary Update or later (build 1607+).
17-
18-
To find your PC's architecture and Windows build number, open
19-
**Settings** > **System** > **About**
20-
21-
Look for the **OS Build** and **System Type** fields.
22-
![](media/system.png)
23-
2416
## Install the Windows Subsystem for Linux
2517
Enable the "Windows Subsystem for Linux" optional feature and reboot.
2618

@@ -33,7 +25,7 @@ Enable the "Windows Subsystem for Linux" optional feature and reboot.
3325
3426
## Fall Creators Update and later: Install from the Windows Store
3527
36-
> This section is for Windows Insiders (build 16215 or later). Follow these steps to [Check your build](install_guide.md#prerequisites). For earlier versions of Windows 10, follow [these instructions using lxrun](install_guide.md#for-anniversary-update-and-creators-update-install-using-lxrun).
28+
> This section is for Windows Insiders (build 16215 or later). Follow these steps to [Check your build](troubleshooting.md#check-your-build-number). For earlier versions of Windows 10, follow [these instructions using lxrun](install-win10.md#for-anniversary-update-and-creators-update-install-using-lxrun).
3729
3830
1. Open the Windows Store and choose your favorite Linux distribution.
3931
Here are links directly to the store installers:
@@ -56,18 +48,19 @@ Enable the "Windows Subsystem for Linux" optional feature and reboot.
5648
5749
> **Troubleshooting: Installation failed with error 0x8007007e**
5850
> This error occurs when your system doesn't support Linux from the store. Make sure that:
59-
> * You're running Windows build 16215 or later. [Check your build](install_guide.md#prerequisites).
60-
> * The Windows Subsystem for Linux optional component is enabled. [Instructions here](install_guide.md#Install-the-Windows-Subsystem-for-Linux).
51+
> * You're running Windows build 16215 or later. [Check your build](troubleshooting.md#check-your-build-number).
52+
> * The Windows Subsystem for Linux optional component is enabled and the computer has restarted. [Make sure WSL is enabled](troubleshooting.md#confirm-wsl-is-enabled).
53+
6154
6255
63-
5. Create your UNIX username and password. This user account can be different from, and has no relationship to, your Windows username and password. [Read more](https://msdn.microsoft.com/en-us/commandline/wsl/user_support).
56+
5. Create your UNIX username and password. This user account can be different from, and has no relationship to, your Windows username and password. [Read more](user-support.md).
6457
6558
You're done! Now you can use your Linux environment.
6659
6760
## For Anniversary Update and Creators Update: Install using lxrun
6861
lxrun installs Ubuntu user-mode by default on top of the Windows subsystem for Linux.
6962
70-
> Since moving to the store, we have stopped keeping this user-mode image up to date. When you're done, run apt-get update.
63+
> Since moving to the store, we have stopped keeping this user-mode image up to date. When you're done, run `apt-get update`.
7164
7265
1. Turn on Developer Mode
7366
@@ -90,11 +83,6 @@ lxrun installs Ubuntu user-mode by default on top of the Windows subsystem for L
9083
The first time you install the Windows subsystem for Linux, you will be prompted to create a UNIX username and password.
9184
![](media/new-user.png)
9285
93-
This UNIX username and password can be different from, and has no relationship to, your Windows username and password. [Learn more about your UNIX account.](https://msdn.microsoft.com/en-us/commandline/wsl/user_support).
94-
95-
After installation your Linux distribution will be located at: `%localappdata%\lxss\`.
96-
97-
**Avoid creating and/or modifying files in %localappdata%\lxss\ using Windows tools and apps!** If you do, it is likely that your Linux files will be corrupted and data loss may occur. Avoid this issue by using a directory located under /mnt/.
98-
Read this [blog post](https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/) for more information.
86+
This UNIX username and password can be different from, and has no relationship to, your Windows username and password. [Learn more about your UNIX account.](user-support.md).
9987
100-
You're done! Go use your new Linux environment!
88+
After installation your Linux distribution will be located at: `%localappdata%\lxss\`.

‎commandline/WSL/interop.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: Windows interoperability with Linux
33
description: Describes Windows interoperability with Linux distributions running on the Windows Subsystem for Linux.
44
author: scooley
5+
ms.author: scooley
56
ms.date: 7/31/2017
67
ms.topic: article
78
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/reference.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Windows Subsystem for Linux Command Reference
33
description: List of commands that manage the Windows Subsystem for Linux
44
keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu
55
author: scooley
6+
ms.author: scooley
67
ms.date: 7/31/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/release-notes.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
21
---
32
title: Release Notes
43
description: Release notes for the Windows Subsystem for Linux. Updated weekly.

‎commandline/WSL/troubleshooting.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: Troubleshooting the Windows Susbystem for Linux
33
description: Provides detailed information about common errors and issues people run into while running Linux on the Windows Susbystem for Linux.
44
keywords: BashOnWindows, bash, wsl, windows, windowssubsystem, ubuntu
5+
author: scooley
56
ms.author: scooley
67
ms.date: 11/15/2017
78
ms.topic: article
@@ -136,6 +137,14 @@ To collect a memory dump:
136137
7. Restore the memory dump type to the original setting.
137138

138139
### Check your build number
140+
141+
To find your PC's architecture and Windows build number, open
142+
**Settings** > **System** > **About**
143+
144+
Look for the **OS Build** and **System Type** fields.
145+
![](media/system.png)
146+
147+
139148
To find your Windows Server build number, run the following in PowerShell:
140149
``` PowerShell
141150
systeminfo | Select-String "^OS Name","^OS Version"

‎commandline/WSL/user-support.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Linux User Account and Permissions
33
description: Reference for user accounts and permission management with the Windows Subsystem for Linux.
44
keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu, user accounts
55
author: scooley
6+
ms.author: scooley
67
ms.date: 9/11/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

‎commandline/WSL/wsl-config.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Manage Linux Distributions
33
description: Reference listing and configuring multiple Linux distributions running on the Windows Subsystem for Linux.
44
keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu
55
author: scooley
6+
ms.author: scooley
67
ms.date: 10/13/2017
78
ms.topic: article
89
ms.prod: windows-subsystem-for-linux

0 commit comments

Comments
 (0)