changing default from conceptual to reference, and marking those topics that should be conceptual

TylerMSFT · TylerMSFT · commit 42b320f668b8 · 2020-09-28T17:21:58.000-07:00
diff --git a/docs/c-runtime-library/ansi-c-compliance.md b/docs/c-runtime-library/ansi-c-compliance.md
@@ -1,6 +1,8 @@
 ---
 title: "ANSI C Compliance"
+description: "An overview of Microsoft C runtime naming conventions for ANSI C compliance."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["Ansi"]
 helpviewer_keywords: ["underscores, leading", "compatibility [C++], ANSI C", "compliance with ANSI C", "conventions [C++], Microsoft extensions", "underscores", "naming conventions [C++], Microsoft library", "ANSI [C++], C standard", "Microsoft extensions naming conventions"]
 ms.assetid: 6be271bf-eecf-491a-a928-0ee2dd60e3b9
diff --git a/docs/c-runtime-library/backward-compatibility.md b/docs/c-runtime-library/backward-compatibility.md
@@ -1,6 +1,8 @@
 ---
 title: "Backward Compatibility"
+description: "How to use the Microsoft OLDNAMES.LIB library to map function names for backwards compatibility."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["CRT, compatibility", "backward compatibility, C run-time libraries", "compatibility, C run-time libraries", "backward compatibility"]
 ms.assetid: cc3175cf-97fd-492f-b329-5791aea63090
 ---
diff --git a/docs/c-runtime-library/byte-and-wide-streams.md b/docs/c-runtime-library/byte-and-wide-streams.md
@@ -1,6 +1,8 @@
 ---
 title: "Byte and Wide Streams"
+description: "An overview of byte streams in the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["Byte and Wide Streams"]
 helpviewer_keywords: ["byte streams", "wide streams"]
 ms.assetid: 61ef0587-4cbc-4eb8-aae5-4c298dbbc6f9
diff --git a/docs/c-runtime-library/code-pages.md b/docs/c-runtime-library/code-pages.md
@@ -1,5 +1,7 @@
 ---
 title: "Code Pages"
+description: "A description of code page support in the Microsoft C runtime."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["character sets [C++], code pages", "ANSI [C++], code pages", "system-default code page", "multibyte code pages [C++]", "localization [C++], code pages", "code pages [C++], types of", "locale code pages [C++]"]
 ms.assetid: 4a26fc42-185a-4add-98bf-a7b314ae6186
diff --git a/docs/c-runtime-library/compatibility.md b/docs/c-runtime-library/compatibility.md
@@ -2,6 +2,7 @@
 title: "Compatibility"
 description: "Describes the compatibility of the Microsoft Universal C runtime library (UCRT) with the Standard C library, POSIX, the Safe CRT, and Store apps."
 ms.date: "9/11/2020"
+ms.topic: "conceptual"
 helpviewer_keywords: ["CRT, compatibility", "compatibility, C runtime libraries", "compatibility"]
 ms.assetid: 346709cb-edda-4909-9a19-3d253eddb6b7
 ---
diff --git a/docs/c-runtime-library/controlling-streams.md b/docs/c-runtime-library/controlling-streams.md
@@ -1,6 +1,8 @@
 ---
 title: "Controlling Streams"
+description: "An overview of working with streams in the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["Controlling Streams"]
 helpviewer_keywords: ["streams, controlling", "controlling streams", "streams"]
 ms.assetid: 267e9013-9afc-45f6-91e3-ca093230d9d9
diff --git a/docs/c-runtime-library/crt-initialization.md b/docs/c-runtime-library/crt-initialization.md
@@ -1,12 +1,14 @@
 ---
 title: "CRT Initialization"
+description: "Describes how the CRT initializes global state in native code."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["CRT initialization [C++]"]
 ms.assetid: e7979813-1856-4848-9639-f29c86b74ad7
 ---
 # CRT Initialization
 
-This topic describes how the CRT initializes global states in native code.
+This topic describes how the CRT initializes global state in native code.
 
 By default, the linker includes the CRT library, which provides its own startup code. This startup code initializes the CRT library, calls global initializers, and then calls the user-provided `main` function for console applications.
 
diff --git a/docs/c-runtime-library/crt-library-features.md b/docs/c-runtime-library/crt-library-features.md
@@ -1,7 +1,8 @@
 ---
 title: "CRT Library Features"
-description: "The files that contain the Microsoft C run-time libraries, and their associated compiler options and preprocessor directives."
+description: "List of files that contain the Microsoft C run-time libraries, and their associated compiler options and preprocessor directives."
 ms.date: 09/03/2020
+ms.topic: "conceptual"
 helpviewer_keywords: ["MSVCR71.dll", "libraries [C++], multithreaded", "library files, run-time", "LIBCMT.lib", "LIBCP.lib", "LIBCPMT.lib", "run-time libraries, C", "CRT, release versions", "MSVCP71.dll", "LIBC.lib", "libraries [C++]", "libraries [C++], run-time", "linking [C++], libraries"]
 ms.assetid: a889fd39-807d-48f2-807f-81492612463f
 ---
diff --git a/docs/c-runtime-library/direction-flag.md b/docs/c-runtime-library/direction-flag.md
@@ -1,6 +1,8 @@
 ---
 title: "Direction Flag"
+description: "Describes the effect of the CPU direction flag on Microsoft C runtime functions."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["direction flag"]
 ms.assetid: 0836b4af-dbbb-4ab8-a4b2-156f2e2099e2
 ---
diff --git a/docs/c-runtime-library/files-and-streams.md b/docs/c-runtime-library/files-and-streams.md
@@ -1,6 +1,8 @@
 ---
 title: "Files and Streams"
+description: "An overview of files and streams in the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["files [C++]", "streams"]
 ms.assetid: f61e712b-eac9-4c28-bb18-97c3786ef387
 ---
diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md
@@ -1,6 +1,7 @@
 ---
 title: "Global state in the CRT"
-description: "Describes how shared global state is handled in the Universal C Runtime." 
+description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." 
+ms.topic: "conceptual"
 ms.date: "04/02/2020"
 helpviewer_keywords: ["CRT global state"]
 ---
diff --git a/docs/c-runtime-library/internationalization.md b/docs/c-runtime-library/internationalization.md
@@ -1,6 +1,8 @@
 ---
 title: "Internationalization"
 ms.date: "11/04/2016"
+description: "A description of Microsoft runtime library support for writing a program intended for international markets."
+ms.topic: "conceptual"
 helpviewer_keywords: ["localization, routines for", "locale-dependent routines", "internationalization routines", "international applications, run-time routines for"]
 ms.assetid: ee536a04-3558-4729-8e10-6dabcde055fd
 ---
diff --git a/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md b/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md
@@ -1,5 +1,7 @@
 ---
 title: "Locale Names, Languages, and Country-Region Strings"
+description: "An overview of using Microsoft Universal CRT locale, language, and country and region strings."
+ms.topic: "conceptual"
 ms.date: "12/10/2018"
 helpviewer_keywords: ["country/region strings", "localization, locale", "locales", "setlocale function", "language strings"]
 ms.assetid: a0e5a0c5-5602-4da0-b65f-de3d6c8530a2
diff --git a/docs/c-runtime-library/multithreaded-libraries-performance.md b/docs/c-runtime-library/multithreaded-libraries-performance.md
@@ -1,6 +1,8 @@
 ---
 title: "Multithreaded Libraries Performance"
+description: "An overview of how to get the most performance from the Microsoft C runtime multithreaded libraries."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["threading [C++], performance", "libraries, multithreaded", "performance, multithreading", "multithreaded libraries"]
 ms.assetid: faa5d808-087c-463d-8f0d-8c478d137296
 ---
diff --git a/docs/c-runtime-library/parameter-validation.md b/docs/c-runtime-library/parameter-validation.md
@@ -1,6 +1,8 @@
 ---
 title: "Parameter Validation"
+description: "A description of parameter validation in the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["parameters, validation"]
 ms.assetid: 019dd5f0-dc61-4d2e-b4e9-b66409ddf1f2
 ---
diff --git a/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md b/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md
@@ -1,6 +1,8 @@
 ---
 title: "Potential Errors Passing CRT Objects Across DLL Boundaries"
+description: "An overview of potential problems you may encounter when passing Microsoft C runtime objects across a dynamic link library (DLL) boundary."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["DLL conflicts [C++]"]
 ms.assetid: c217ffd2-5d9a-4678-a1df-62a637a96460
 ---
diff --git a/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md b/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md
@@ -2,6 +2,7 @@
 title: "Recommendations for Choosing Between Functions and Macros"
 description: "Explains the differences between using macros vs functions in the Microsoft C runtime library (CRT)"
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["c.functions"]
 helpviewer_keywords: ["functions [CRT], vs. macros", "macros, vs. functions"]
 ms.assetid: 18a633d6-cf1c-470c-a649-fa7677473e2b
diff --git a/docs/c-runtime-library/required-and-optional-header-files.md b/docs/c-runtime-library/required-and-optional-header-files.md
@@ -1,6 +1,8 @@
 ---
 title: "Required and Optional Header Files"
+description: "When to use required versus optional header files from the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["c.headers"]
 helpviewer_keywords: ["include files, required in run time", "header files, required in run time"]
 ms.assetid: f64d0bf5-e2c3-4b42-97d0-443b3d901d9f
diff --git a/docs/c-runtime-library/sal-annotations.md b/docs/c-runtime-library/sal-annotations.md
@@ -1,6 +1,8 @@
 ---
 title: "SAL Annotations"
+description: "A brief description of the Microsoft source-code annotation language (SAL)."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["__z annotation", "ref annotation", "_opt annotation", "__checkreturn annotatioin", "__deref_opt annotation", "deref_opt annotation", "__deref annotation", "__in annotation", "annotations [C++]", "z annotation", "_inout annotation", "__ref annotation", "full annotation", "_in annotation", "_ref annotation", "__out annotation", "_ecount annotation", "SAL annotations", "__opt annotation", "inout annotation", "in annotation", "_CA_SHOULD_CHECK_RETURN", "__bcount annotation", "_full annotation", "_bcount annotation", "deref annotation", "part annotation", "_out annotation", "__nz annotation", "__part annotation", "opt annotation", "__full annotation", "_nz annotation", "_z annotation", "out annotation", "__ecount annotation", "__inout annotation", "SAL annotations, _CA_SHOULD_CHECK_RETURN", "_deref_opt annotation", "_deref annotation", "nz annotation", "_part annotation", "ecount annotation", "bcount annotation"]
 ms.assetid: 81893638-010c-41a0-9cb3-666fe360f3e0
 ---
diff --git a/docs/c-runtime-library/sbcs-and-mbcs-data-types.md b/docs/c-runtime-library/sbcs-and-mbcs-data-types.md
@@ -1,5 +1,7 @@
 ---
 title: "SBCS and MBCS Data Types"
+description: "How to represent single and multibyte characters in the Microsoft C runtime."
+ms.topic: "conceptual"
 ms.date: "04/11/2018"
 f1_keywords: ["MBCS", "SBCS"]
 helpviewer_keywords: ["SBCS and MBCS data types", "data types [C], MBCS and SBCS"]
diff --git a/docs/c-runtime-library/secure-template-overloads.md b/docs/c-runtime-library/secure-template-overloads.md
@@ -1,6 +1,8 @@
 ---
 title: "Secure Template Overloads"
+description: "A description of Microsoft C runtime template overloads that provide security-enhanced functions."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT"]
 helpviewer_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT", "secure template overloads"]
 ms.assetid: 562741d0-39c0-485e-8529-73d740f29f8f
diff --git a/docs/c-runtime-library/security-features-in-the-crt.md b/docs/c-runtime-library/security-features-in-the-crt.md
@@ -1,6 +1,8 @@
 ---
 title: "Security Features in the CRT"
+description: "An overview of secure CRT functions in the Microsoft C runtime."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["_CRT_SECURE_NO_DEPRECATE", "_CRT_NONSTDC_NO_WARNINGS", "_CRT_SECURE_NO_WARNINGS"]
 helpviewer_keywords: ["security deprecation warnings [C++]", "CRT_NONSTDC_NO_DEPRECATE", "buffers [C++], buffer overruns", "deprecation warnings (security-related), disabling", "_CRT_NONSTDC_NO_WARNINGS", "security [CRT]", "_CRT_SECURE_NO_WARNINGS", "_CRT_NONSTDC_NO_DEPRECATE", "_CRT_SECURE_NO_DEPRECATE", "security-enhanced CRT", "CRT_SECURE_NO_WARNINGS", "CRT_SECURE_NO_DEPRECATE", "deprecation warnings (security-related)", "buffer overruns", "CRT_NONSTDC_NO_WARNINGS", "CRT, security enhancements", "parameters [C++], validation"]
 ms.assetid: d9568b08-9514-49cd-b3dc-2454ded195a3
diff --git a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md
@@ -1,5 +1,7 @@
 ---
 title: "Single-Byte and Multibyte Character Sets"
+description: "An introduction to single and multi-byte character sets in the Microsoft runtime library."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["SBCS (single byte character set)", "MBCS [C++], about MBCS", "character sets [C++], multibyte", "character sets [C++], single byte"]
 ms.assetid: 2cbc78ea-33c0-4cfb-b0df-7ce2458431ce
diff --git a/docs/c-runtime-library/text-and-binary-streams.md b/docs/c-runtime-library/text-and-binary-streams.md
@@ -1,6 +1,8 @@
 ---
 title: "Text and Binary Streams"
+description: "A description of text and binary streams in the Microsoft C runtime library."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 helpviewer_keywords: ["binary streams", "text streams"]
 ms.assetid: 57035e4a-955d-4e04-a560-fcf67ce68b4e
 ---
diff --git a/docs/c-runtime-library/tgmath.md b/docs/c-runtime-library/tgmath.md
@@ -1,6 +1,7 @@
 ---
 title: "Type-generic math"
 description: "Describes macros in <tgmath.h> that make it easier to write C code that calls the right math function, based on argument type." 
+ms.topic: "conceptual"
 ms.date: "9/3/2020"
 helpviewer_keywords: ["CRT tgmath.h"]
 ---
diff --git a/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md b/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md
@@ -1,5 +1,7 @@
 ---
 title: "Unicode Stream I/O in Text and Binary Modes"
+description: "A description of character conversions with Unicode stream I/O."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["stream I/O routines", "I/O [CRT], unicode stream", "Unicode, stream I/O routines", "Unicode stream I/O"]
 ms.assetid: 68be0c3e-a9e6-4fd5-b34a-1b5207f0e7d6
diff --git a/docs/c-runtime-library/unicode-the-wide-character-set.md b/docs/c-runtime-library/unicode-the-wide-character-set.md
@@ -1,5 +1,7 @@
 ---
 title: "Unicode: The Wide-Character Set"
+description: "An introduction to the Unicode wide character set in the Microsoft C runtime."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["Unicode [C++], wide character set", "wide characters [C++], Unicode"]
 ms.assetid: b6a05a21-59a5-4d30-8c85-2dbe185f7a74
diff --git a/docs/c-runtime-library/unix.md b/docs/c-runtime-library/unix.md
@@ -1,6 +1,8 @@
 ---
 title: "UNIX"
+description: "Guidelines for porting your program to Unix."
 ms.date: "11/04/2016"
+ms.topic: "conceptual"
 f1_keywords: ["unix"]
 helpviewer_keywords: ["UNIX", "POSIX compatibility", "POSIX file names", "UNIX, compatibility"]
 ms.assetid: 40792414-7a5b-415d-bfa8-2bfb1ebb3731
diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md
@@ -1,5 +1,7 @@
 ---
 title: "Using Generic-Text Mappings"
+description: "An introduction to Microsoft-specific mappings for data types, routines, and other objects in the C runtime."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 f1_keywords: ["_UNICODE"]
 helpviewer_keywords: ["_TXCHAR type", "TINT type", "_TCHAR type", "TSCHAR type", "TEXT type", "TCHAR type", "TCHAR.H data types, mappings defined in", "generic-text data types", "_TINT type", "TUCHAR type", "_UNICODE constant", "TXCHAR type", "generic-text mappings", "_TSCHAR type", "T type", "mappings, generic-text", "_TUCHAR type", "MBCS data type", "_MBCS data type", "_TEXT type", "UNICODE constant", "_T type"]
diff --git a/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md b/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md
@@ -1,5 +1,7 @@
 ---
 title: "Using TCHAR.H Data Types with _MBCS"
+description: "An overview of how Microsoft C runtime text routines are mapped when you use TCHAR.H data types with the multi byte constant _MBCS ."
+ms.topic: "conceptual"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["TCHAR.H data types", "MBCS data type", "_MBCS data type"]
 ms.assetid: 48f471e7-9d2b-4a39-b841-16a0e15c0a18
diff --git a/docs/docfx.json b/docs/docfx.json
@@ -96,6 +96,7 @@
         "atl-mfc-shared/**.md": "reference",
         "build/reference/**.md": "reference",
         "c-language/**.md": "language-reference",
+        "c-runtime-library/**.md": "reference",
         "c-runtime-library/reference/**.md": "reference",
         "code-quality/**.md": "reference",
         "cpp/**.md": "language-reference",
