Skip to content

Commit 73de1a1

Browse files
committed
fix: MD006/ul-start-left
Consider starting bulleted lists at the beginning of the line
1 parent 02de957 commit 73de1a1

22 files changed

+174
-170
lines changed

.markdownlint.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@
33
"MD001": false,
44
"MD002": false,
55
"MD004": false,
6-
"MD006": false,
76
"MD007": false,
87
"MD009": false,
98
"MD011": false,

docs/code-quality/cpp-core-guidelines-warnings.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -78,17 +78,17 @@ The C++ Core Guidelines are there to help you write better and safer code. Howev
7878

7979
As new rules are added to the C++ Core Guidelines Checker, the number of warnings that are produced for pre-existing code may increase. You can use predefined rule sets to filter which kinds of rules to enable. As of Visual Studio 2017 version 15.3, the supported rule sets are:
8080

81-
- **Owner Pointer Rules** enforce [resource-management checks related to owner\<T> from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
81+
- **Owner Pointer Rules** enforce [resource-management checks related to owner\<T> from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
8282

83-
- **Const Rules** enforce [const-related checks from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability).
83+
- **Const Rules** enforce [const-related checks from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability).
8484

85-
- **Raw Pointer Rules** enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
85+
- **Raw Pointer Rules** enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
8686

87-
- **Unique Pointer Rules** enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
87+
- **Unique Pointer Rules** enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).
8888

89-
- **Bounds Rules** enforce the [Bounds profile of the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile).
89+
- **Bounds Rules** enforce the [Bounds profile of the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile).
9090

91-
- **Type Rules** enforce the [Type profile of the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile).
91+
- **Type Rules** enforce the [Type profile of the C++ Core Guidelines](http://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile).
9292

9393
You can choose to limit warnings to just one or a few of the groups. The **Native Minimum** and **Native Recommended** rule sets include C++ Core Check rules in addition to other PREfast checks. To see the available rule sets, open the Project Properties dialog, select **Code Analysis\General**, open the dropdown in the **Rule Sets** combo-box, and pick **Choose multiple rule sets**. For more information about using Rule Sets in Visual Studio, see [Using Rule Sets to Group Code Analysis Rules](using-rule-sets-to-group-code-analysis-rules.md).
9494

docs/debugger/autos-and-locals-windows.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -79,9 +79,9 @@ Set a breakpoint and start debugging. When the breakpoint is hit, execution paus
7979

8080
## <a name="bkmk_whatvariables"></a> Variables in the Autos window (C#, C++, Visual Basic, Python)
8181

82-
Different code languages display different variables in the **Autos** window.
82+
Different code languages display different variables in the **Autos** window.
8383

84-
- In C# and Visual Basic, the **Autos** window displays any variable used on the current or preceding line. For example, in C# or Visual Basic code, declare the following four variables:
84+
- In C# and Visual Basic, the **Autos** window displays any variable used on the current or preceding line. For example, in C# or Visual Basic code, declare the following four variables:
8585

8686
```csharp
8787
public static void Main()
@@ -100,7 +100,7 @@ Set a breakpoint and start debugging. When the breakpoint is hit, execution paus
100100

101101
The value of `c` is 0, because the line `c = 3` has not yet been executed.
102102

103-
- In C++, the **Autos** window displays the variables used in at least three lines before the current line where execution is paused. For example, in C++ code, declare six variables:
103+
- In C++, the **Autos** window displays the variables used in at least three lines before the current line where execution is paused. For example, in C++ code, declare six variables:
104104

105105
```C++
106106
void main() {

docs/debugger/debug-using-the-just-in-time-debugger.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -90,11 +90,11 @@ To enable Just-In-Time debugging instead of standard Windows Form error handling
9090
For more information, see <xref:System.Diagnostics.DebuggableAttribute>.
9191

9292
## <a name="BKMK_Using_JIT"></a>Use Just-In-Time debugging
93-
This example walks you through Just-In-Time debugging when an app throws an error.
93+
This example walks you through Just-In-Time debugging when an app throws an error.
9494

95-
- You must have Visual Studio installed to follow these steps. If you don't have Visual Studio, you can download the free [Visual Studio Community Edition](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&rel=15).
95+
- You must have Visual Studio installed to follow these steps. If you don't have Visual Studio, you can download the free [Visual Studio Community Edition](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&rel=15).
9696

97-
- Make sure Just-In-Time debugging is [enabled](#BKMK_Enabling) in **Tools** > **Options** > **Debugging** > **Just-In-Time**.
97+
- Make sure Just-In-Time debugging is [enabled](#BKMK_Enabling) in **Tools** > **Options** > **Debugging** > **Just-In-Time**.
9898

9999
For this example, you'll make a C# console app in Visual Studio that throws a [NullReferenceException](/dotnet/api/system.nullreferenceexception).
100100

docs/debugger/historical-debugging.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,8 @@ Historical debugging is a mode of debugging that depends on the information coll
2525

2626
## How do I start using historical debugging?
2727

28-
IntelliTrace is on by default. All you have to do is decide which events and function calls are of interest to you, and whether you want to view snapshots of your full application state. For more information about defining what you want to look for, see [IntelliTrace Features](../debugger/intellitrace-features.md). Feature support varies by language and app type.
28+
IntelliTrace is on by default. All you have to do is decide which events and function calls are of interest to you, and whether you want to view snapshots of your full application state. For more information about defining what you want to look for, see [IntelliTrace Features](../debugger/intellitrace-features.md). Feature support varies by language and app type.
2929

30-
- To view snapshots with historical debugging, see [Inspect previous app states using IntelliTrace](../debugger/view-historical-application-state.md)
31-
- To learn how to inspect variables and navigate code, see [Inspect your app with historical debugging](../debugger/historical-debugging-inspect-app.md)
32-
- To learn more about debugging with IntelliTrace events, see [Walkthrough: Using IntelliTrace](../debugger/walkthrough-using-intellitrace.md).
30+
- To view snapshots with historical debugging, see [Inspect previous app states using IntelliTrace](../debugger/view-historical-application-state.md)
31+
- To learn how to inspect variables and navigate code, see [Inspect your app with historical debugging](../debugger/historical-debugging-inspect-app.md)
32+
- To learn more about debugging with IntelliTrace events, see [Walkthrough: Using IntelliTrace](../debugger/walkthrough-using-intellitrace.md).

docs/extensibility/ux-guidelines/ux-essentials-for-visual-studio.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,11 +47,12 @@ ms.workload:
4747
## Screen resolution
4848

4949
### Minimum resolution
50-
- The minimum resolution for Visual Studio Dev14 is **1280x720**. This means that it is *possible* to use Visual Studio at this resolution, although it might not be an optimal user experience. There is no guarantee that all aspects will be usable at resolutions lower than 1280x720.
5150

52-
- The target resolution for Visual Studio is **1366x768**. This is the lowest resolution at which we promise a *good* user experience.
51+
- The minimum resolution for Visual Studio Dev14 is **1280x720**. This means that it is *possible* to use Visual Studio at this resolution, although it might not be an optimal user experience. There is no guarantee that all aspects will be usable at resolutions lower than 1280x720.
5352

54-
- Initial dialog height should be **smaller than 700 pixels**, so it fits within the minimum resolution of the IDE frame at 96 dpi.
53+
- The target resolution for Visual Studio is **1366x768**. This is the lowest resolution at which we promise a *good* user experience.
54+
55+
- Initial dialog height should be **smaller than 700 pixels**, so it fits within the minimum resolution of the IDE frame at 96 dpi.
5556

5657
### High-density displays
5758
UI in Visual Studio must work well in all DPI scaling factors that Windows supports out of the box: 150%, 200%, and 250%.

docs/ide/dotfuscator/install.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ You can install Dotfuscator Community from the Visual Studio IDE:
4343
1. In the **Search Box** (Ctrl+Q), type `dotfuscator`. <br/> <br/> ![Search Box](media/install_in_vs19_12.png) <br/> <br/>
4444

4545
2. In the search results shown, under the *Components* heading, select **Install PreEmptive Protection - Dotfuscator**.
46-
* If you instead see, under the *Menus* heading, **PreEmptive Protection - Dotfuscator Community**, then Dotfuscator Community is already installed. Select that option to [get started][get-started].
46+
* If you instead see, under the *Menus* heading, **PreEmptive Protection - Dotfuscator Community**, then Dotfuscator Community is already installed. Select that option to [get started][get-started].
4747

4848
3. A Visual Studio Installer window will launch, pre-configured to install Dotfuscator Community.
4949
> [!NOTE]

docs/ide/how-to-view-save-and-configure-build-log-files.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,10 @@ ms.workload:
1414

1515
After you build a project in the Visual Studio IDE, you can view information about that build in the **Output** window. By using this information, you can, for example, troubleshoot a build failure.
1616

17-
- For C++ projects, you can also view the same information in a *.txt* file that's created and saved automatically.
17+
- For C++ projects, you can also view the same information in a *.txt* file that's created and saved automatically.
18+
19+
- For managed code projects, you can click in the build output window and press **Ctrl**+**S**. Visual Studio prompts you for a location to save the information from the **Output** window into a *.txt* file.
1820

19-
- For managed code projects, you can click in the build output window and press **Ctrl**+**S**. Visual Studio prompts you for a location to save the information from the **Output** window into a *.txt* file.
20-
2121
You can also use the IDE to specify what kinds of information you want to view about each build.
2222

2323
If you build any kind of project by using MSBuild, you can create a *.txt* file to save information about the build. For more information, see [Obtain build logs](../msbuild/obtaining-build-logs-with-msbuild.md).

docs/ide/reference/generate-constructor.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,11 @@ This code generation applies to:
2424

2525
**How:** There are several ways to generate a constructor:
2626

27-
- [Generate constructor and pick members](#pick)
28-
- [Generate constructor from selected fields](#selection)
29-
- [Generate constructor from new usage](#usage)
30-
- [Add parameter to existing constructor](#addparameter)
31-
- [Create and initialize field/property from a constructor parameter](#create)
27+
- [Generate constructor and pick members](#pick)
28+
- [Generate constructor from selected fields](#selection)
29+
- [Generate constructor from new usage](#usage)
30+
- [Add parameter to existing constructor](#addparameter)
31+
- [Create and initialize field/property from a constructor parameter](#create)
3232

3333
## <a id = "pick"></a> Generate constructor and pick members (C# only)
3434

docs/install/using-visual-studio-vm.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -71,13 +71,13 @@ If the images don't include a Visual Studio feature that you require, provide fe
7171

7272
Azure offers a full range of virtual machine sizes. Because Visual Studio is a powerful, multi-threaded application, you want a VM size that includes at least two processors and 7 GB of memory. We recommend the following VM sizes for the Visual Studio images:
7373

74-
* Standard_D2_v3
75-
* Standard_D2s_v3
76-
* Standard_D4_v3
77-
* Standard_D4s_v3
78-
* Standard_D2_v2
79-
* Standard_D2S_v2
80-
* Standard_D3_v2
74+
* Standard_D2_v3
75+
* Standard_D2s_v3
76+
* Standard_D4_v3
77+
* Standard_D4s_v3
78+
* Standard_D2_v2
79+
* Standard_D2S_v2
80+
* Standard_D3_v2
8181

8282
For more information on the latest machine sizes, see [Sizes for Windows virtual machines in Azure](/azure/virtual-machines/windows/sizes).
8383

docs/javascript/javascript-in-vs-2017.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -46,14 +46,14 @@ To compile JavaScript files, a `tsconfig.json` file must be added, and some of t
4646

4747
The required settings for the tsconfig file are as follows:
4848

49-
- `allowJs`: This value must be set to `true` for JavaScript files to be recognized. The default value is `false`, because TypeScript compiles to JavaScript, and the compiler should not include files it just compiled.
50-
- `outDir`: This value should be set to a location not included in the project, in order that the emitted JavaScript files are not detected and then included in the project (see `exclude`).
51-
- `module`: If using modules, this setting tells the compiler which module format the emitted code should use (for example `commonjs` for Node, or bundlers such as Browserify).
52-
- `exclude`: This setting states which folders not to include in the project.
53-
The output location, as well as non-project folders such as `node_modules` or `temp`, should be added to this setting.
54-
- `enableAutoDiscovery`: This setting enables the automatic detection and download of definition files as outlined previously.
55-
- `compileOnSave`: This setting tells the compiler if it should recompile any time a source file is saved in Visual Studio.
56-
- `typeAcquisition`: This set of settings control the behavior of automatic type acquisition (further explain in [this section](/visualstudio/ide/javascript-intellisense#Auto))
49+
- `allowJs`: This value must be set to `true` for JavaScript files to be recognized. The default value is `false`, because TypeScript compiles to JavaScript, and the compiler should not include files it just compiled.
50+
- `outDir`: This value should be set to a location not included in the project, in order that the emitted JavaScript files are not detected and then included in the project (see `exclude`).
51+
- `module`: If using modules, this setting tells the compiler which module format the emitted code should use (for example `commonjs` for Node, or bundlers such as Browserify).
52+
- `exclude`: This setting states which folders not to include in the project.
53+
The output location, as well as non-project folders such as `node_modules` or `temp`, should be added to this setting.
54+
- `enableAutoDiscovery`: This setting enables the automatic detection and download of definition files as outlined previously.
55+
- `compileOnSave`: This setting tells the compiler if it should recompile any time a source file is saved in Visual Studio.
56+
- `typeAcquisition`: This set of settings control the behavior of automatic type acquisition (further explain in [this section](/visualstudio/ide/javascript-intellisense#Auto))
5757

5858
In order to convert JavaScript files to CommonJS modules and place them in an `./out` folder, you could use the following `tsconfig.json` file:
5959

docs/profiling/shutdown.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ VSPerfCmd.exe /Shutdown[:Timeout]
2323
```
2424

2525
#### Parameters
26-
`Timeout`
27-
- (Optional) If specified, the option returns after the specified number of seconds without turning off the profiler or closing the profiling data file.
26+
`Timeout`
27+
- (Optional) If specified, the option returns after the specified number of seconds without turning off the profiler or closing the profiling data file.
2828

2929
## See also
3030
- [VSPerfCmd](../profiling/vsperfcmd.md)

0 commit comments

Comments
 (0)