Initial commit for wasdk file-folder content

Author: alvinashcraft

hub/apps/develop/data-and-files.md

@@ -22,7 +22,7 @@ The [Windows App SDK](../windows-app-sdk/index.md) provides the following featur
 
 Windows 10 and later OS releases provide a wide variety of APIs related to data and files scenarios for apps. These features are available via a combination of WinRT and Win32 (C++ and COM) APIs provided by the [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk).
 
-#### WinRT APIs
+### WinRT APIs
 
 The following articles provide information about features available via WinRT APIs provided by the Windows SDK.
 
@@ -32,7 +32,7 @@ The following articles provide information about features available via WinRT AP
 | [Data binding](/windows/uwp/data-binding/) | Learn how to bind your app's UI to data and keep the UI in sync with changes to the data. |
 | [Files, folders, and libraries](/windows/uwp/files/) | Learn how to read and write text and other data formats in files, and to manage files and folders. |
 
-#### Win32 (C++ and COM) APIs
+### Win32 (C++ and COM) APIs
 
 The following articles provide information about features available via Win32 (C++ and COM) APIs provided by the Windows SDK.
 

hub/apps/develop/data-binding/bind-to-hierarchical-data-and-create-a-master-details-view.md

@@ -1,14 +1,14 @@
 ---
 ms.assetid: 6c563dd4-3dd0-4175-a1ab-7a1103fc9559
-title: Bind hierarchical data and create a master/details view
+title: Bind hierarchical data and create a master/details view with Windows App SDK
 description: You can make a multi-level master/details (also known as list-details) view of hierarchical data by binding items controls to CollectionViewSource instances that are bound together in a chain.
 ms.date: 12/13/2022
 ms.topic: article
 keywords: windows 10, windows 11, winui, windows app sdk, windows ui, xBind
 ms.localizationpriority: medium
 ---
 
-# Bind hierarchical data and create a master/details view
+# Bind hierarchical data and create a master/details view with Windows App SDK
 
 > [!NOTE]
 > Also see the [Master/detail UWP sample](https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/XamlMasterDetail).

hub/apps/develop/data-binding/data-binding-and-mvvm.md

@@ -1,14 +1,14 @@
 ---
 ms.assetid: b7a8ec88-3013-4e5a-a110-fab3f20ee4bf
-title: Data binding and MVVM
+title: Windows data binding and MVVM
 description: Data binding is at the core of the Model-View-ViewModel (MVVM) UI architectural design pattern, and enables loose coupling between UI and non-UI code.
 ms.date: 12/13/2022
 ms.topic: article
 keywords: windows 10, windows 11, windows app sdk, winui, windows ui, mvvm
 ms.localizationpriority: medium
 ---
 
-# Data binding and MVVM
+# Windows data binding and MVVM
 
 Model-View-ViewModel (MVVM) is a UI architectural design pattern for decoupling UI and non-UI code. With MVVM, you define your UI declaratively in XAML and use data binding markup to link it to other layers containing data and commands. The data binding infrastructure provides a loose coupling that keeps the UI and the linked data synchronized and routes user input to the appropriate commands.
 

hub/apps/develop/data-binding/data-binding-in-depth.md

@@ -1,6 +1,6 @@
 ---
 ms.assetid: 2a50c798-6244-4fda-9091-a10a9e87fae2
-title: Data binding in depth
+title: Windows data binding in depth
 description: Learn how to use data binding in Windows App SDK applications
 ms.date: 12/12/2022
 ms.topic: article
@@ -11,7 +11,7 @@ dev_langs:
   - cppwinrt
 ---
 
-# Data binding in depth
+# Windows data binding in depth
 
 In this article, we will describe the Windows App SDK data binding features for the APIs that reside in the [**Microsoft.UI.Xaml.Data** namespace](/windows/windows-app-sdk/api/winrt/microsoft.ui.xaml.data).
 

hub/apps/develop/data-binding/data-binding-overview.md

@@ -1,6 +1,6 @@
 ---
 ms.assetid: 02a08657-285d-4804-a006-168c22aa4904
-title: Data binding overview
+title: Windows data binding overview
 description: This topic shows you how to bind a control (or other UI element) to a single item or bind an item's control to a collection of items in a Windows App SDK app.
 ms.date: 12/12/2022
 ms.topic: article
@@ -10,7 +10,7 @@ dev_langs:
   - csharp
 ---
 
-# Data binding overview
+# Windows data binding overview
 
 This topic shows you how to bind a control (or other UI element) to a single item or bind an items control to a collection of items in a Windows App SDK app. In addition, we show how to control the rendering of items, implement a details view based on a selection, and convert data for display. For more detailed info, see [Data binding in depth](data-binding-in-depth.md).
 

hub/apps/develop/data-binding/function-bindings.md

@@ -1,13 +1,13 @@
 ---
 description: Learn about using functions as the leaf step of the data binding path in the xBind markup extension.
-title: Functions in x:Bind
+title: Functions in x:Bind with Windows App SDK
 ms.date: 12/13/2022
 ms.topic: article
 keywords: windows 10, windows 11, windows app sdk, xaml, winui, windows ui, xBind
 ms.localizationpriority: medium
 ---
 
-# Functions in x:Bind
+# Functions in x:Bind with Windows App SDK
 
 > [!NOTE]
 > For general info about using data binding in your app with `{x:Bind}` (and for an all-up comparison between `{x:Bind}` and `{Binding}`), see [Data binding in depth](data-binding-in-depth.md) and [{x:Bind} Markup Extension](/windows/uwp/xaml-platform/x-bind-markup-extension).

hub/apps/develop/files/dotnet-files.md

@@ -0,0 +1,16 @@
+---
+ms.assetid: 5931d63c-6b80-4e47-b371-ee299e308b8e
+title: Access files and folders with Windows App SDK and .NET
+description: Learn about reading and writing files, working with folders, and reading drive and volume information with .NET APIs and the Windows App SDK.
+ms.date: 06/16/2023
+ms.topic: article
+keywords: windows 10, windows 11, windows, winui, windows app sdk, dotnet
+ms.localizationpriority: medium
+---
+# Access files and folders with Windows App SDK and .NET
+
+## Read and write files with .NET APIs
+
+## Working with drives and folders in .NET
+
+## See also

hub/apps/develop/files/index.md

@@ -0,0 +1,52 @@
+---
+ms.assetid: 33d8df1e-898d-48b7-9399-1aee673490d9
+title: Files, folders, and libraries with Windows App SDK
+description: Learn about reading and writing app settings, file and folder pickers, and special sand-boxed locations such as the Video/Music library with Windows App SDK apps.
+ms.date: 06/16/2023
+ms.topic: article
+keywords: windows 10, windows 11, windows, winui, windows app sdk, winrt, dotnet
+ms.localizationpriority: medium
+---
+# Files, folders, and libraries with Windows App SDK
+
+Packaged Windows App SDK apps can use the APIs in the [Windows.Storage](/uwp/api/Windows.Storage), [Windows.Storage.Streams](/uwp/api/Windows.Storage.Streams), and [Windows.Storage.Pickers](/uwp/api/Windows.Storage.Pickers) namespaces to read and write text and other data formats in files, and to manage files and folders. In this section, you'll also learn about reading and writing app settings, about file and folder pickers, and about special sand-boxed locations such as the Video/Music library.
+
+Windows 10 and later OS releases provide a wide variety of APIs related to files, folders, libraries, and settings for apps. These features are available via a combination of WinRT and .NET APIs provided by the [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk) and [.NET SDK](https://dotnet.microsoft.com/en-us/download).
+
+## Read and write data with WinRT storage APIs
+
+Packaged apps have access to all the WinRT storage APIs available to UWP apps. Whether you're migrating an existing UWP app or creating a new app, you can use these APIs to read and write data. For examples of using the storage APIs in a WinUI app, see [Access files and folders with Windows App SDK and WinRT APIs](winrt-files.md).
+
+## Read and write data with .NET file APIs
+
+In addition to the WinRT APIs, packaged apps can use the .NET APIs in the [System.IO](/dotnet/api/system.io) namespace to read and write data. When a new WinUI 3 project is created, its `Package.appxmanifest` file contains the following setting:
+
+``` xml
+<Capabilities>
+  <rescap:Capability Name="runFullTrust" />
+</Capabilities>
+```
+
+Declaring this restricted capability provides full access to the file system, registry, and other restricted capabilities. For more info, see [Restricted capability declarations](/windows/uwp/packaging/app-capability-declarations#restricted-capability-declarations). In other words, the app has the same access to the file system as any other .NET desktop app when using the .NET file APIs.
+
+For examples of using the .NET APIs in a WinUI app, see [Access files and folders with Windows App SDK and .NET APIs](dotnet-files.md).
+
+## Additional resources for working with files and folders
+
+| Topic | Description |
+|-------|-------------|
+| [Enumerate and query files and folders](/windows/uwp/files/quickstart-listing-files-and-folders) | Access files and folders in either a folder, library, device, or network   location. You can also query the files and folders in a location by constructing file and folder queries. |
+| [Create, write, and read a file](/windows/uwp/files/quickstart-reading-and-writing-files) | Read and write a file using a [StorageFile](/uwp/api/Windows.Storage.StorageFile) object. |
+| [Best practices for writing to files](/windows/uwp/files/best-practices-for-writing-to-files) | Learn best practices for using various file writing methods of the [FileIO](/uwp/api/windows.storage.fileio) and [PathIO](/uwp/api/windows.storage.pathio) classes. |
+| [Get file properties](/windows/uwp/files/quickstart-getting-file-properties) | Get properties—top-level, basic, and extended—for a file represented by a   [StorageFile](/uwp/api/Windows.Storage.StorageFile) object. |
+| [Open files and folders with a picker](/windows/uwp/files/quickstart-using-file-and-folder-pickers) | Access files and folders by letting the user interact with a picker. You can use the   [FolderPicker](/uwp/api/Windows.Storage.Pickers.FolderPicker) to gain access to a folder. |
+| [Save a file with a picker](/windows/uwp/files/quickstart-save-a-file-with-a-picker) | Use [FileSavePicker](/uwp/api/Windows.Storage.Pickers.FileSavePicker) to let users specify the name and location where they want your app to save a file. |
+| [Accessing HomeGroup content](/windows/uwp/files/quickstart-accessing-homegroup-content) | Access content stored in the user's HomeGroup folder, including pictures, music, and videos. |
+| [Determining availability of Microsoft OneDrive files](/windows/uwp/files/quickstart-determining-availability-of-microsoft-onedrive-files) | Determine if a Microsoft OneDrive file is available using the [StorageFile.IsAvailable](/uwp/api/windows.storage.storagefile.isavailable) property. |
+| [Files and folders in the Music, Pictures, and Videos libraries](/windows/uwp/files/quickstart-managing-folders-in-the-music-pictures-and-videos-libraries) | Add existing folders of music, pictures, or videos to the corresponding libraries. You can also remove folders from libraries, get the list of folders in a library, and discover stored photos, music, and videos. |
+| [Track recently used files and folders](/windows/uwp/files/how-to-track-recently-used-files-and-folders) | Track files that your user accesses frequently by adding them to your app's most recently used list (MRU). The platform manages the MRU for you by sorting items based on when they were last accessed, and by removing the oldest item when the list's 25-item limit is reached. All apps have their own MRU. |
+| [Track file system changes in the background](/windows/uwp/files/change-tracking-filesystem) | Track changes to the file system, even when the app isn't running.|
+| [Access the SD card](/windows/uwp/files/access-the-sd-card) | You can store and access non-essential data on an optional microSD card, especially on low-cost mobile devices that have limited internal storage. |
+| [Fast access to file properties](/windows/uwp/files/fast-file-properties) | Efficiently gather a list of files and their properties from a library to use via the Windows Runtime APIs. |
+
+## See also

hub/apps/develop/files/winrt-files.md

@@ -0,0 +1,18 @@
+---
+ms.assetid: 385ede76-fb55-4ef4-a16b-3d9ccfc7367a
+title: Access files and folders with Windows App SDK and WinRT APIs
+description: Learn about using WinRT APIs with Windows App SDK apps for reading and writing app settings, file and folder pickers, and special sand-boxed locations such as the Video/Music library.
+ms.date: 06/16/2023
+ms.topic: article
+keywords: windows 10, windows 11, windows, winui, windows app sdk, winrt
+ms.localizationpriority: medium
+---
+# Access files and folders with Windows App SDK and WinRT APIs
+
+## Query files and folders
+
+## Get file properties
+
+## Files and folders in Windows libraries
+
+## See also

hub/apps/toc.yml

@@ -441,6 +441,14 @@ items:
                 href: develop/data-binding/bind-to-hierarchical-data-and-create-a-master-details-view.md
               - name: Data binding and MVVM
                 href: develop/data-binding/data-binding-and-mvvm.md
+          - name: Files, folders, and libraries
+            items:
+              - name: Files, folders, and libraries
+                href: develop/files/index.md
+              - name: Access files and folders with .NET
+                href: develop/files/dotnet-files.md
+              - name: File access with Windows Runtime APIs
+                href: develop/files/winrt-files.md
           - name: Data and files overview
             href: develop/data-and-files.md
       - name: Communication