Skip to content

Commit 4bc5df8

Browse files
Merge pull request #5337 from MicrosoftDocs/cinnamon/advanced-settings
Initial Advanced Settings docs
2 parents fe05700 + 0cfc28c commit 4bc5df8

15 files changed

+81
-47
lines changed

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8870,6 +8870,11 @@
88708870
"redirect_url": "/windows/uwp/get-started/winui2/release-notes/winui-2.8",
88718871
"redirect_document_id": false
88728872
},
8873+
{
8874+
"source_path": "hub/sudo/index.md",
8875+
"redirect_url": "/windows/advanced-settings/sudo/",
8876+
"redirect_document_id": false
8877+
},
88738878
{
88748879
"source_path": "hub/apps/develop/actions/action-json.md",
88758880
"redirect_url": "/windows/ai/app-actions/actions-json",
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: File Explorer Version Control Integration (PREVIEW)
3+
description: Learn how to use File Explorer + version control integration inside Windows Advanced settings.
4+
ms.reviewer: cinnamon
5+
ms.topic: article
6+
ms.date: 04/11/2025
7+
---
8+
9+
# File Explorer version control integration (PREVIEW)
10+
11+
**File Explorer version control integration** provides version control information directly in File Explorer. This includes information such as the branch name, last commit author, last commit message, and more.
12+
13+
> [!NOTE]
14+
> As of right now, File Explorer version control integration only supports Git. The Advanced Settings system component is extensible to allow for additional version control types.
15+
16+
![File Explorer version control integration](../images/fe-source.png)
17+
18+
## Prerequisites
19+
20+
File Explorer version control integration is available in the [Windows Beta channel](https://aka.ms/BetaLatest). See [Get started with the Windows Insider Program](/windows-insider/get-started) for more information about joining the program and selecting a channel. After you've joined the Beta channel, you can ([check for Windows updates](ms-settings:windowsupdate)).
21+
22+
## How to identify repositories
23+
24+
Windows has to know which folders are source code repositories so File Explorer can display the version control information. You can select your repository folders in Windows Advanced Settings > File Explorer settings under the File Explorer + version control header.
25+
26+
![File Explorer version control Settings](../images/fe-source-settings.png)

hub/advanced-settings/index.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: Advanced Windows Settings (PREVIEW)
3+
description: Learn about the settings provided in the Advanced page of Windows settings.
4+
ms.reviewer: cinnamon
5+
ms.topic: article
6+
ms.date: 04/10/2025
7+
---
8+
9+
# Advanced Windows Settings (PREVIEW)
10+
11+
**Advanced Windows settings** is a redesign of the original **For Developers** page in Windows settings with additional settings to help you be more productive.
12+
13+
## Prerequisites
14+
15+
Advanced settings is available in the [Windows Beta channel](https://aka.ms/BetaLatest). See [Get started with the Windows Insider Program](/windows-insider/get-started) for more information about joining the program and selecting a channel. After you've joined the Beta channel, you can ([check for Windows updates](ms-settings:windowsupdate)).
16+
17+
## FAQ
18+
19+
### Why was For Developers renamed to Advanced?
20+
21+
Most of the settings available within the For Developers page are useful for other advanced Windows users as well. In order to help all users discover these settings, the page was redesigned and renamed to Advanced.
22+
23+
## Windows Advanced Settings system component open source repository
24+
25+
To provide enhanced functionality to the Advanced settings page, there is an open-source system component that enables features like [File Explorer version control integration](fe-version-control.md). We welcome your contributions and feedback, and the source code for the Windows Advanced Settings system component is available on [GitHub](https://github.com/microsoft/windowsAdvancedSettings).

hub/sudo/index.md renamed to hub/advanced-settings/sudo/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ The Sudo for Windows command is available in [Windows 11, version 24H2](https://
2424

2525
To enable Sudo for Windows, open `Settings > System > For Developers` and set **Enable sudo** to **On**.
2626

27-
![Enable Sudo](../images/sudo-enable.png)
27+
![Enable Sudo](../../images/sudo-enable.png)
2828

2929
>[!WARNING]
3030
> Sudo for Windows can be used as a potential escalation of privilege vector when enabled in certain configurations. You should make sure to be aware of the [security considerations](#security-considerations) when enabling the sudo command on your machine.

hub/dev-environment/toc.yml

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,14 @@ items:
44
- name: Developer tools
55
expanded: true
66
items:
7+
- name: Advanced Windows settings
8+
items:
9+
- name: Overview
10+
href: ../advanced-settings/index.md
11+
- name: File Explorer + version control
12+
href: ../advanced-settings/fe-version-control.md
13+
- name: Sudo for Windows
14+
href: ../advanced-settings/sudo/index.md
715
- name: Dev Drive
816
items:
917
- name: Overview
@@ -866,8 +874,6 @@ items:
866874
href: ../powertoys/hosts-file-editor.md
867875
- name: Registry Preview
868876
href: ../powertoys/registry-preview.md
869-
- name: Sudo for Windows
870-
href: ../sudo/index.md
871877
- name: Windows Package Manager
872878
items:
873879
- name: Overview

hub/dev-home/environments.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,21 @@
11
---
22
title: Environments in Dev Home
33
description: Learn about interacting with your virtual or cloud environments from Dev Home.
4-
ms.date: 01/28/2025
4+
ms.date: 05/19/2025
55
ms.topic: overview
66
---
77

88
# Environments in Dev Home
99

1010
> [!IMPORTANT]
11-
> Dev Home will be going away in May 2025 and a subset of its features will be moved to new places. Stay tuned for more information in the following months.
11+
> Starting May 2025, Dev Home will no longer be supported as a feature in Windows 11. See [Advanced Windows settings](../advanced-settings/index.md) for information on File Explorer version control integration, Sudo for Windows, and additional developer features coming soon.
1212
1313
A virtual environment is a self-contained workspace that allows you to maintain separate dependencies and settings for different projects, effectively isolating them from each other. The type of virtual environments supported and maintained by Microsoft currently include:
1414

1515
- [Local Hyper-V virtual machine (VM)](/windows-server/virtualization/hyper-v/get-started/create-a-virtual-machine-in-hyper-v)
1616
- [Microsoft Dev Box](/azure/dev-box/overview-what-is-microsoft-dev-box)
1717
- [Windows Subsystem for Linux (WSL) distribution](/windows/wsl/install)
1818

19-
To add your own environment to Dev Home, see: [Build an extension for Environments in Dev Home](#build-an-extension-for-environments-in-dev-home).
20-
2119
**Environments in Dev Home** centralize your interactions with virtual or cloud environments in a single place.
2220

2321
- View all of your environments in a single place
@@ -97,9 +95,3 @@ Alternatively, you can remotely configure your environment:
9795
5. Review your configuration. Once complete, the virtual environment will be configured with your selected resources. You may be asked to enter user credentials for the specific environment to apply these changes.
9896

9997
![Machine configuration](../images/devhome-environment-config.png)
100-
101-
## Build an Extension for Environments in Dev Home
102-
103-
If there is a type of virtual environment that you regularly use that is currently unsupported by Dev Home, you can build your own Dev Home Environment Extension to display the virtual environment in Dev Home.
104-
105-
To build an environment extension, see our guidance and API documentation on GitHub: [Developer environments in Dev Home](https://github.com/microsoft/devhome/blob/main/docs/extensions/environments/readme.md).

hub/dev-home/extensions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Dev Home Extensions
33
description: Dev Home supports both default and custom-built extensions. Learn more about the Dev Home GitHub extension, how to customize Git widgets and notifications in the Dev Home dashboard, and how to build your own Dev Home extension.
4-
ms.date: 01/28/2025
4+
ms.date: 05/19/2025
55
ms.topic: overview
66
---
77

88
# Dev Home extensions
99

1010
> [!IMPORTANT]
11-
> Dev Home will be going away in May 2025 and a subset of its features will be moved to new places. Stay tuned for more information in the following months.
11+
> Starting May 2025, Dev Home will no longer be supported as a feature in Windows 11. See [Advanced Windows settings](../advanced-settings/index.md) for information on File Explorer version control integration, Sudo for Windows, and additional developer features coming soon.
1212
1313
Dev Home supports both default and custom-built extensions. Learn more about the Dev Home GitHub extension, how to customize Git widgets and notifications in the Dev Home dashboard, and how to build your own Dev Home extension.
1414

hub/dev-home/index.md

Lines changed: 4 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Dev Home for Windows Developers
33
description: Dev Home is a new control center for Windows providing the ability to track your workflows and coding tasks using customizable widgets, set up your dev environment, connect to your developer accounts and tools (such as GitHub), and install apps and packages all in one place.
4-
ms.date: 01/28/2025
4+
ms.date: 05/19/2025
55
ms.topic: overview
66
---
77

88
# What is Dev Home?
99

1010
> [!IMPORTANT]
11-
> Dev Home will be going away in May 2025 and a subset of its features will be moved to new places. Stay tuned for more information in the following months.
11+
> Starting May 2025, Dev Home will no longer be supported as a feature in Windows 11. See [Advanced Windows settings](../advanced-settings/index.md) for information on File Explorer version control integration, Sudo for Windows, and additional developer features coming soon.
1212
1313
Dev Home is a new control center for Windows providing the ability to monitor projects in your dashboard using customizable widgets, set up your dev environment by downloading apps, packages, or repositories, connect to your developer accounts and tools (such as GitHub), and create a [Dev Drive](../dev-drive/index.md) for storage all in one place.
1414

@@ -89,20 +89,11 @@ The [Dev Home Azure extension](https://apps.microsoft.com/detail/9MV8F79FGXTR) p
8989

9090
Environments in Dev Home can help you to centralize your interactions with virtual or cloud environments in a single place. Quickly launch, start, stop, or sync virtual environments, seamlessly integrating with the Windows OS. Learn more about **[Environments in Dev Home](./environments.md)**.
9191

92-
![Environments in Dev Home](../images/devhome-environment-manage.png)
93-
94-
## Experimental features
95-
96-
Dev Home supports experimenting with developer-focused features. Features that are identified as "Experimental" may be added and removed from release to release.
97-
98-
A few recent Dev Home Experimental features have included "Dev Diagnostics," a way to consolidate diagnostic tools, and "Quickstart Playground," an AI integration for generating app development projects in Visual Studio Code. You can find these Experimental features tracked in the [Dev Home Release Notes]( https://github.com/microsoft/devhome/releases).
99-
10092
## Dev Home open source repos
10193

10294
Both Dev Home and Dev Home GitHub extension are open source and welcome your contributions.
10395

104-
- [Dev Home repository on GitHub](https://github.com/microsoft/devhome).
96+
- [Dev Home repository on GitHub](https://github.com/microsoft/devhome)
97+
- [Dev Home Release Notes]( https://github.com/microsoft/devhome/releases)
10598
- [Dev Home GitHub extension repository on GitHub](https://github.com/microsoft/devhomegithubextension)
10699
- [Dev Home Azure extension repository on GitHub](https://github.com/microsoft/devhomeazureextension)
107-
108-
You can also contribute to the open source documentation for Dev Home by visiting the [Windows Dev Docs open source repo on GitHub](https://github.com/MicrosoftDocs/windows-dev-docs/issues).

hub/dev-home/setup.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
---
22
title: Dev Home Machine Configuration
33
description: Set up your Windows development environment with Dev Home by using the integrated set up tool to get your machine to a development-ready state. Use the step-by-step graphical interface to walk through the setup process or use a WinGet Configuration file with pre-defined setup requirements.
4-
ms.date: 01/28/2025
4+
ms.date: 05/19/2025
55
ms.topic: overview
66
---
77

88
# Dev Home Machine Configuration - Set up your Windows development environment
99

1010
> [!IMPORTANT]
11-
> Dev Home will be going away in May 2025 and a subset of its features will be moved to new places. Stay tuned for more information in the following months.
11+
> Starting May 2025, Dev Home will no longer be supported as a feature in Windows 11. See [Advanced Windows settings](../advanced-settings/index.md) for information on File Explorer version control integration, Sudo for Windows, and additional developer features coming soon.
1212
1313
The Dev Home machine configuration tool brings all of your dev environment set up tasks into one place, enabling you to efficiently set up a new machine or onboard new projects.
1414

@@ -41,5 +41,3 @@ When using Dev Home to clone a repository, once you have selected a repo (or mul
4141
If you have not yet created a Dev Drive, you will have the option to create one using Dev Home. Check the box to optimize the performance of your workloads with a Dev Drive. Then you can customize a few options, such as the drive letter, name, size, and location of the dynamic VHDX on which the Dev Drive will be created. The name will be used for both the VHDX file and the Dev Drive. By default, the options are the next available drive letter, size of 50GB, and created at `%userprofile%\DevDrives`.
4242

4343
![Screenshot of Dev Home Machine configuration being used to clone a repository.](../images/devhome-github-setup.png)
44-
45-
Learn more about what you can do with **[Dev Home](./index.md)**.

hub/dev-home/utilities.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,14 @@
11
---
22
title: Dev Home utilities
33
description: Get access to developer utilities directly in Windows through Dev Home.
4-
ms.date: 01/28/2025
4+
ms.date: 05/19/2025
55
ms.topic: overview
66
---
77

88
# Use developer utilities delivered with Dev Home
99

1010
> [!IMPORTANT]
11-
> Dev Home will be going away in May 2025 and a subset of its features will be moved to new places. Stay tuned for more information in the following months.
12-
13-
Dev Home brings a set of utilities that are helpful to developers directly to Windows. [Microsoft PowerToys](../powertoys/index.md) now delivers some of its utilities within Dev Home, making it even easier to use these tools.
14-
15-
![Dev Home utilities screenshot](../images/dev-home-utilities.png)
11+
> Starting May 2025, Dev Home will no longer be supported as a feature in Windows 11. See [Advanced Windows settings](../advanced-settings/index.md) for information on File Explorer version control integration, Sudo for Windows, and additional developer features coming soon.
1612
1713
## Environment Variables
1814

0 commit comments

Comments
 (0)