resource file consolidation pr45

Author: msebolt

.openpublishing.redirection.json

@@ -7915,6 +7915,11 @@
             "redirect_url": "/cpp/windows/how-to-create-a-resource-script-file",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/windows/files-affected-by-resource-editing.md",
+            "redirect_url": "/cpp/windows/editable-file-types-for-resources",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/windows/activationfactory-activationfactory-constructor.md",
             "redirect_url": "/cpp/windows/activationfactory-class#activationfactory",

docs/windows/TOC.md

@@ -19,7 +19,6 @@
 #### [How to: Import and Export Resources](how-to-import-and-export-resources.md)
 #### [Editable File Types for Resources](editable-file-types-for-resources.md)
 #### [Editing Managed Resource Files](editing-managed-resource-files.md)
-#### [Files Affected by Resource Editing](files-affected-by-resource-editing.md)
 #### [Manifest Resources](manifest-resources.md)
 ### [Symbols: Resource Identifiers](symbols-resource-identifiers.md)
 #### [Viewing Resource Symbols](viewing-resource-symbols.md)

docs/windows/editable-file-types-for-resources.md

@@ -2,7 +2,7 @@
 title: "Editable File Types for Resources (C++)"
 ms.date: "11/04/2016"
 f1_keywords: ["vc.editors.resource"]
-helpviewer_keywords: ["file types [C++], for resources", "resources [C++], editing", "files [C++], editable types"]
+helpviewer_keywords: ["file types [C++], for resources", "resources [C++], editing", "files [C++], editable types", "resource editing"]
 ms.assetid: c40f9204-f2f2-400b-9f53-53b7bf291356
 ---
 # Editable File Types for Resources (C++)
@@ -19,10 +19,20 @@ You can open the following types of files and edit the resources they contain.
 |.dll|Dynamic-link library files.|
 |.bmp, .ico, .dib, and .cur|Bitmap, icon, toolbar and cursor files.|
 
+## Files affected by resource editing
+
+The Visual Studio environment works with the files shown in the following table during your resource editing session.
+
+|File name|Description|
+|---------------|-----------------|
+|Resource.h|Header file generated by the development environment; contains symbol definitions. (Include this file in source control.)|
+|Filename.aps|Binary version of the current resource script file; used for quick loading.<br /><br /> The resource editors do not directly read .rc or resource.h files. The resource compiler compiles them into .aps files, which are consumed by the resource editors. This file is a compile step and only stores symbolic data. As with a normal compile process, information that is not symbolic (for example, comments) is discarded during the compile process. Whenever the .aps file gets out of synch with the .rc file, the .rc file is regenerated (for example, when you Save, the resource editor overwrites the .rc file and the resource.h file). Any changes to the resources themselves will remain incorporated in the .rc file, but comments will always be lost once the .rc file is overwritten. For information on how to preserve comments, see [Including Resources at Compile Time](../windows/how-to-include-resources-at-compile-time.md). (Typically, you should not include the .aps file in source control.)|
+|.rc|Resource script file that contains script for the resources in your current project. This file is overwritten by the .aps file whenever you save. (Include this file in source control.)|
+
 ## Requirements
 
 Win32
 
-## See Also
+## See also
 
 [Resource Files](../windows/resource-files-visual-studio.md)