Skip to content

Commit 7580755

Browse files
authored
Merge pull request #4988 from MicrosoftDocs/master
7/11/2019 AM Publish
2 parents 208395b + ceef57e commit 7580755

File tree

198 files changed

+3039
-2933
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

198 files changed

+3039
-2933
lines changed

.markdownlint.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
"default": true,
33
"MD001": false,
44
"MD004": false,
5-
"MD007": false,
65
"MD009": false,
76
"MD011": false,
87
"MD013": false,

docs/ai/installation.md

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -82,27 +82,27 @@ Then, we need to verify whether Python 3.5 is installed correctly, and upgrade p
8282

8383
- **Windows**
8484

85-
```cmd
86-
C:\Users\test>python -V
87-
Python 3.5.4
85+
```cmd
86+
C:\Users\test>python -V
87+
Python 3.5.4
8888
89-
C:\Users\test>pip3.5 -V
90-
pip 9.0.1 from c:\users\test\appdata\local\programs\python\python35\lib\site-packages (python 3.5)
89+
C:\Users\test>pip3.5 -V
90+
pip 9.0.1 from c:\users\test\appdata\local\programs\python\python35\lib\site-packages (python 3.5)
9191
92-
C:\Users\test>python -m pip install -U pip
93-
```
92+
C:\Users\test>python -m pip install -U pip
93+
```
9494

9595
- **macOS**
9696

97-
```bash
98-
MyMac:~ test$ python3.5 -V
99-
Python 3.5.4
97+
```bash
98+
MyMac:~ test$ python3.5 -V
99+
Python 3.5.4
100100

101-
MyMac:~ test$ pip3.5 -V
102-
pip 9.0.1 from /Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site-packages (python 3.5)
101+
MyMac:~ test$ pip3.5 -V
102+
pip 9.0.1 from /Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site-packages (python 3.5)
103103

104-
MyMac:~ test$ python3.5 -m pip install -U pip
105-
```
104+
MyMac:~ test$ python3.5 -m pip install -U pip
105+
```
106106

107107
### Python on Visual Studio
108108

@@ -156,15 +156,15 @@ To install MXNet, run the following command in a terminal:
156156

157157
- With GPU
158158

159-
```bash
160-
pip3.5 install mxnet-cu80==0.12.0
161-
```
159+
```bash
160+
pip3.5 install mxnet-cu80==0.12.0
161+
```
162162

163163
- Without GPU
164164

165-
```bash
166-
pip3.5 install mxnet==0.12.0
167-
```
165+
```bash
166+
pip3.5 install mxnet==0.12.0
167+
```
168168

169169
### Keras
170170

@@ -197,33 +197,33 @@ To install PyTorch, run the following command in a terminal:
197197

198198
- **Windows**
199199

200-
There's no official wheel package yet. You can download a third-party package from [Anaconda](https://anaconda.org/pytorch/repo?type=all) or [University of California](https://www.lfd.uci.edu/~gohlke/pythonlibs/#pytorch).
200+
There's no official wheel package yet. You can download a third-party package from [Anaconda](https://anaconda.org/pytorch/repo?type=all) or [University of California](https://www.lfd.uci.edu/~gohlke/pythonlibs/#pytorch).
201201

202-
- Decompress it to your home directory, for example, *C:\Users\test\pytorch*.
203-
- Add *C:\Users\test\pytorch\Lib\site-packages* to the %PYTHONPATH% environment variable.
202+
- Decompress it to your home directory, for example, *C:\Users\test\pytorch*.
203+
- Add *C:\Users\test\pytorch\Lib\site-packages* to the %PYTHONPATH% environment variable.
204204

205-
```bash
206-
pip3 install http://download.pytorch.org/whl/cu80/torch-0.4.0-cp36-cp36m-win_amd64.whl
207-
pip3 install torchvision
208-
```
205+
```bash
206+
pip3 install http://download.pytorch.org/whl/cu80/torch-0.4.0-cp36-cp36m-win_amd64.whl
207+
pip3 install torchvision
208+
```
209209

210210
- **macOS**
211211

212-
```bash
213-
pip3.5 install http://download.pytorch.org/whl/torch-0.2.0.post3-cp35-cp35m-macosx_10_7_x86_64.whl
214-
```
212+
```bash
213+
pip3.5 install http://download.pytorch.org/whl/torch-0.2.0.post3-cp35-cp35m-macosx_10_7_x86_64.whl
214+
```
215215

216-
> [!NOTE]
217-
> macOS binaries don't support CUDA, install from source if CUDA is needed
216+
> [!NOTE]
217+
> macOS binaries don't support CUDA, install from source if CUDA is needed
218218
219219
- **Linux**
220220
221-
```bash
222-
pip3.5 install http://download.pytorch.org/whl/cu80/torch-0.2.0.post3-cp35-cp35m-manylinux1_x86_64.whl
223-
```
221+
```bash
222+
pip3.5 install http://download.pytorch.org/whl/cu80/torch-0.2.0.post3-cp35-cp35m-manylinux1_x86_64.whl
223+
```
224224
225-
> [!NOTE]
226-
> This single package supports both GPU and CPU.
225+
> [!NOTE]
226+
> This single package supports both GPU and CPU.
227227
228228
Finally, install torchvision on non-Windows:
229229
@@ -248,4 +248,4 @@ To install Chainer, please run the following command in a terminal:
248248
249249
```bash
250250
pip3.5 install chainer==3.0.0
251-
```
251+
```

docs/code-quality/ca1507.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ Rule CA1507 flags the use of a `string` literal as an argument to a method or co
3535

3636
- The constant value of the `string` literal matches either of the following:
3737

38-
- The name of a parameter of the method, lambda, or local function within which the method or constructor is being invoked.
38+
- The name of a parameter of the method, lambda, or local function within which the method or constructor is being invoked.
3939

40-
- The name of a property of the type within which the method or constructor is being invoked.
40+
- The name of a property of the type within which the method or constructor is being invoked.
4141

4242
- The argument corresponds to a `string`-typed parameter of the method or the constructor that's being invoked (that is, there is no conversion involved at the call site).
4343

@@ -81,4 +81,4 @@ It's safe to suppress a violation of this rule if you're not concerned about the
8181

8282
## See also
8383

84-
- [Maintainability warnings](../code-quality/maintainability-warnings.md)
84+
- [Maintainability warnings](../code-quality/maintainability-warnings.md)

docs/code-quality/in-source-suppression-overview.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -61,17 +61,17 @@ The properties of the attribute include:
6161
6262
- **Scope** - The target on which the warning is being suppressed. If the target is not specified, it is set to the target of the attribute. Supported [scopes](xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute.Scope) include the following:
6363
64-
- `module`
64+
- `module`
6565
66-
- `resource`
66+
- `resource`
6767
68-
- `type`
68+
- `type`
6969
70-
- `member`
70+
- `member`
7171
72-
- `namespace` - This scope suppresses warnings against the namespace itself. It does not suppress warnings against types within the namespace.
72+
- `namespace` - This scope suppresses warnings against the namespace itself. It does not suppress warnings against types within the namespace.
7373
74-
- `namespaceanddescendants` - (New for Visual Studio 2019) This scope suppresses warnings in a namespace and all its descendant symbols. The `namespaceanddescendants` value is only valid for Roslyn analyzers, and is ignored by binary, FxCop-based static analysis.
74+
- `namespaceanddescendants` - (New for Visual Studio 2019) This scope suppresses warnings in a namespace and all its descendant symbols. The `namespaceanddescendants` value is only valid for Roslyn analyzers, and is ignored by binary, FxCop-based static analysis.
7575
7676
- **Target** - An identifier that is used to specify the target on which the warning is being suppressed. It must contain a fully qualified item name.
7777
@@ -165,4 +165,4 @@ The global suppression file maintains suppressions that are either global-level
165165

166166
- <xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute.Scope>
167167
- <xref:System.Diagnostics.CodeAnalysis>
168-
- [Use Roslyn analyzers](../code-quality/use-roslyn-analyzers.md)
168+
- [Use Roslyn analyzers](../code-quality/use-roslyn-analyzers.md)

docs/code-quality/use-roslyn-analyzers.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -104,40 +104,40 @@ There are multiple ways to suppress rule violations:
104104

105105
- From the **Analyze** menu
106106

107-
Select **Analyze** > **Run Code Analysis and Suppress Active Issues** on the menu bar to suppress all current violations. This is sometimes referred to as "baselining".
107+
Select **Analyze** > **Run Code Analysis and Suppress Active Issues** on the menu bar to suppress all current violations. This is sometimes referred to as "baselining".
108108

109109
- From **Solution Explorer**
110110

111-
To suppress a violation in **Solution Explorer**, set the rule's severity to **None**.
111+
To suppress a violation in **Solution Explorer**, set the rule's severity to **None**.
112112

113113
- From the **rule set editor**
114114

115-
To suppress a violation from the rule set editor, uncheck the box next to its name or set **Action** to **None**.
115+
To suppress a violation from the rule set editor, uncheck the box next to its name or set **Action** to **None**.
116116

117117
- From the **code editor**
118118

119-
To suppress a violation from the code editor, place the cursor in the line of code with the violation and press **Ctrl**+**.** to open the **Quick Actions** menu. Select **Suppress CAXXXX** > **in Source/in Suppression File**.
119+
To suppress a violation from the code editor, place the cursor in the line of code with the violation and press **Ctrl**+**.** to open the **Quick Actions** menu. Select **Suppress CAXXXX** > **in Source/in Suppression File**.
120120

121-
![Suppress diagnostic from quick actions menu](media/suppress-diagnostic-from-editor.png)
121+
![Suppress diagnostic from quick actions menu](media/suppress-diagnostic-from-editor.png)
122122

123123
- From the **Error List**
124124

125-
You can suppress one or many diagnostics from the **Error List** by selecting the ones you want to suppress, and then right-clicking and selecting **Suppress** > **In Source/In Suppression File**.
125+
You can suppress one or many diagnostics from the **Error List** by selecting the ones you want to suppress, and then right-clicking and selecting **Suppress** > **In Source/In Suppression File**.
126126

127-
- If you suppress **In Source**, the **Preview Changes** dialog opens and shows a preview of the C# [#pragma warning](/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-pragma-warning) or Visual Basic [#Disable warning](/dotnet/visual-basic/language-reference/directives/directives) directive that's added to the source code.
127+
- If you suppress **In Source**, the **Preview Changes** dialog opens and shows a preview of the C# [#pragma warning](/dotnet/csharp/language-reference/preprocessor-directives/preprocessor-pragma-warning) or Visual Basic [#Disable warning](/dotnet/visual-basic/language-reference/directives/directives) directive that's added to the source code.
128128

129-
![Preview of adding #pragma warning in code file](media/pragma-warning-preview.png)
129+
![Preview of adding #pragma warning in code file](media/pragma-warning-preview.png)
130130

131-
- If you select **In Suppression File**, the **Preview Changes** dialog opens and shows a preview of the <xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute> attribute that's added to the global suppressions file.
131+
- If you select **In Suppression File**, the **Preview Changes** dialog opens and shows a preview of the <xref:System.Diagnostics.CodeAnalysis.SuppressMessageAttribute> attribute that's added to the global suppressions file.
132132

133-
![Preview of adding SuppressMessage attribute to suppression file](media/preview-changes-in-suppression-file.png)
133+
![Preview of adding SuppressMessage attribute to suppression file](media/preview-changes-in-suppression-file.png)
134134

135-
In the **Preview Changes** dialog, select **Apply**.
135+
In the **Preview Changes** dialog, select **Apply**.
136136

137-
> [!NOTE]
138-
> If you don't see the **Suppress** menu option in **Solution Explorer**, the violation is likely coming from build and not live analysis. The **Error List** displays diagnostics, or rule violations, from both live code analysis and build. Since the build diagnostics can be stale, for example, if you've edited the code to fix the violation but haven't rebuilt, you cannot suppress these diagnostics from the **Error List**. Diagnostics from live analysis, or IntelliSense, are always up-to-date with current sources and can be suppressed from the **Error List**. To exclude *build* diagnostics from your selection, switch the **Error List** source filter from **Build + IntelliSense** to **Intellisense Only**. Then, select the diagnostics you want to suppress and proceed as described previously.
139-
>
140-
> ![Error List source filter in Visual Studio](media/error-list-filter.png)
137+
> [!NOTE]
138+
> If you don't see the **Suppress** menu option in **Solution Explorer**, the violation is likely coming from build and not live analysis. The **Error List** displays diagnostics, or rule violations, from both live code analysis and build. Since the build diagnostics can be stale, for example, if you've edited the code to fix the violation but haven't rebuilt, you cannot suppress these diagnostics from the **Error List**. Diagnostics from live analysis, or IntelliSense, are always up-to-date with current sources and can be suppressed from the **Error List**. To exclude *build* diagnostics from your selection, switch the **Error List** source filter from **Build + IntelliSense** to **Intellisense Only**. Then, select the diagnostics you want to suppress and proceed as described previously.
139+
>
140+
> ![Error List source filter in Visual Studio](media/error-list-filter.png)
141141
142142
## Command-line usage
143143

@@ -177,4 +177,4 @@ In a .NET Core project, if you add a reference to a project that has NuGet analy
177177
- [Overview of Roslyn analyzers in Visual Studio](../code-quality/roslyn-analyzers-overview.md)
178178
- [Submit a Roslyn analyzer bug](https://github.com/dotnet/roslyn-analyzers/issues)
179179
- [Use rule sets](../code-quality/using-rule-sets-to-group-code-analysis-rules.md)
180-
- [Suppress code analysis warnings](../code-quality/in-source-suppression-overview.md)
180+
- [Suppress code analysis warnings](../code-quality/in-source-suppression-overview.md)

0 commit comments

Comments
 (0)