Skip to content

Commit 7b1ff85

Browse files
authored
style guide fixes - PR 3/8 (dotnet#1383)
* style guide fixes * Apply suggestions from PR review Co-Authored-By: mairaw <[email protected]>
1 parent 6362503 commit 7b1ff85

File tree

100 files changed

+443
-443
lines changed

Some content is hidden

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

100 files changed

+443
-443
lines changed

xml/System.Activities.XamlIntegration/PropertyReferenceExtension`1.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@
7373
<ReturnType>System.String</ReturnType>
7474
</ReturnValue>
7575
<Docs>
76-
<summary>Get or sets the name of the associated property.</summary>
76+
<summary>Gets or sets the name of the associated property.</summary>
7777
<value>The name of the property.</value>
7878
<remarks>To be added.</remarks>
7979
</Docs>

xml/System.Activities.XamlIntegration/TextExpressionCompilerSettings.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@
137137
</ReturnValue>
138138
<Docs>
139139
<summary>Gets or sets whether the <see cref="T:System.Activities.XamlIntegration.TextExpressionCompilerSettings" /> is for implementation.</summary>
140-
<value>True of the <see cref="T:System.Activities.XamlIntegration.TextExpressionCompilerSettings" /> is for implementation; otherwise, false.</value>
140+
<value><see langword="true" /> if the <see cref="T:System.Activities.XamlIntegration.TextExpressionCompilerSettings" /> is for implementation; otherwise, <see langword="false" />.</value>
141141
<remarks>To be added.</remarks>
142142
</Docs>
143143
</Member>

xml/System.Collections.Immutable/ImmutableDictionary`2+Builder.xml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -783,8 +783,8 @@
783783
<ReturnType>System.Boolean</ReturnType>
784784
</ReturnValue>
785785
<Docs>
786-
<summary>Gets a value indicating whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
787-
<value>true if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, false.</value>
786+
<summary>Gets a value that indicates whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
787+
<value><see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, <see langword="false" />.</value>
788788
<remarks>To be added.</remarks>
789789
</Docs>
790790
</Member>
@@ -953,8 +953,8 @@
953953
<ReturnType>System.Boolean</ReturnType>
954954
</ReturnValue>
955955
<Docs>
956-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.IDictionary" /> object has a fixed size.</summary>
957-
<value>true if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, false.</value>
956+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.IDictionary" /> object has a fixed size.</summary>
957+
<value><see langword="true" /> if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, <see langword="false" />.</value>
958958
<remarks>To be added.</remarks>
959959
</Docs>
960960
</Member>
@@ -980,8 +980,8 @@
980980
<ReturnType>System.Boolean</ReturnType>
981981
</ReturnValue>
982982
<Docs>
983-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
984-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
983+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
984+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
985985
<remarks>To be added.</remarks>
986986
</Docs>
987987
</Member>

xml/System.Collections.Immutable/ImmutableHashSet`1+Builder.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -636,7 +636,7 @@
636636
</ReturnValue>
637637
<Docs>
638638
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
639-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
639+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
640640
<remarks>To be added.</remarks>
641641
</Docs>
642642
</Member>

xml/System.Collections.Immutable/ImmutableList.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@
180180
<typeparam name="T">The type of items in the .</typeparam>
181181
<param name="items">The items to add to the list.</param>
182182
<summary>Creates a new immutable list that contains the specified items.</summary>
183-
<returns>Returns an immutable list that contains the specified items.</returns>
183+
<returns>An immutable list that contains the specified items.</returns>
184184
<remarks>To be added.</remarks>
185185
</Docs>
186186
</Member>

xml/System.Collections.Immutable/ImmutableList`1+Builder.xml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1472,7 +1472,7 @@
14721472
<ReturnType>System.Boolean</ReturnType>
14731473
</ReturnValue>
14741474
<Docs>
1475-
<summary>Gets a value indicating whether this instance is read-only.</summary>
1475+
<summary>Gets a value that indicates whether this instance is read-only.</summary>
14761476
<value>Always <c>false</c>.</value>
14771477
<remarks>To be added.</remarks>
14781478
</Docs>
@@ -1576,8 +1576,8 @@
15761576
<ReturnType>System.Boolean</ReturnType>
15771577
</ReturnValue>
15781578
<Docs>
1579-
<summary>Gets a value indicating whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
1580-
<value>true if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, false.</value>
1579+
<summary>Gets a value that indicates whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
1580+
<value><see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, <see langword="false" />.</value>
15811581
<remarks>To be added.</remarks>
15821582
</Docs>
15831583
</Member>
@@ -1857,8 +1857,8 @@
18571857
<ReturnType>System.Boolean</ReturnType>
18581858
</ReturnValue>
18591859
<Docs>
1860-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.IList" /> has a fixed size.</summary>
1861-
<value>true if the <see cref="T:System.Collections.IList" /> has a fixed size; otherwise, false.</value>
1860+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.IList" /> has a fixed size.</summary>
1861+
<value><see langword="true" /> if the <see cref="T:System.Collections.IList" /> has a fixed size; otherwise, <see langword="false" />.</value>
18621862
<remarks>To be added.</remarks>
18631863
</Docs>
18641864
</Member>
@@ -1884,8 +1884,8 @@
18841884
<ReturnType>System.Boolean</ReturnType>
18851885
</ReturnValue>
18861886
<Docs>
1887-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
1888-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
1887+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
1888+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
18891889
<remarks>To be added.</remarks>
18901890
</Docs>
18911891
</Member>

xml/System.Collections.Immutable/ImmutableList`1.xml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1656,7 +1656,7 @@
16561656
</ReturnValue>
16571657
<Docs>
16581658
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
1659-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
1659+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
16601660
<remarks>To be added.</remarks>
16611661
</Docs>
16621662
</Member>
@@ -2187,7 +2187,7 @@
21872187
</ReturnValue>
21882188
<Docs>
21892189
<summary>Gets a value indicating whether the <see cref="T:System.Collections.IList" /> has a fixed size.</summary>
2190-
<value>true if the <see cref="T:System.Collections.IList" /> has a fixed size; otherwise, false.</value>
2190+
<value><see langword="true" /> if the <see cref="T:System.Collections.IList" /> has a fixed size; otherwise, <see langword="false" />.</value>
21912191
<remarks>To be added.</remarks>
21922192
</Docs>
21932193
</Member>
@@ -2214,7 +2214,7 @@
22142214
</ReturnValue>
22152215
<Docs>
22162216
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
2217-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
2217+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
22182218
<remarks>To be added.</remarks>
22192219
</Docs>
22202220
</Member>
@@ -2539,7 +2539,7 @@
25392539
<param name="value">The value of the element to remove from the list.</param>
25402540
<param name="equalityComparer">The comparer to use to compare elements for equality.</param>
25412541
<summary>Removes the element with the specified value from the list.</summary>
2542-
<returns>Returns a new <see cref="T:System.Collections.Immutable.ImmutableList`1" /> with the specified element removed.</returns>
2542+
<returns>A new <see cref="T:System.Collections.Immutable.ImmutableList`1" /> with the specified element removed.</returns>
25432543
<remarks>
25442544
<format type="text/markdown"><![CDATA[
25452545

xml/System.Collections.Immutable/ImmutableSortedDictionary`2+Builder.xml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -768,8 +768,8 @@
768768
<ReturnType>System.Boolean</ReturnType>
769769
</ReturnValue>
770770
<Docs>
771-
<summary>Gets a value indicating whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
772-
<value>true if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, false.</value>
771+
<summary>Gets a value that indicates whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
772+
<value><see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, <see langword="false" />.</value>
773773
<remarks>To be added.</remarks>
774774
</Docs>
775775
</Member>
@@ -937,8 +937,8 @@
937937
<ReturnType>System.Boolean</ReturnType>
938938
</ReturnValue>
939939
<Docs>
940-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.IDictionary" /> object has a fixed size.</summary>
941-
<value>true if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, false.</value>
940+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.IDictionary" /> object has a fixed size.</summary>
941+
<value><see langword="true" /> if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, <see langword="false" />.</value>
942942
<remarks>To be added.</remarks>
943943
</Docs>
944944
</Member>
@@ -964,8 +964,8 @@
964964
<ReturnType>System.Boolean</ReturnType>
965965
</ReturnValue>
966966
<Docs>
967-
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
968-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
967+
<summary>Gets a value that indicates whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
968+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
969969
<remarks>To be added.</remarks>
970970
</Docs>
971971
</Member>

xml/System.Collections.Immutable/ImmutableSortedDictionary`2.xml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -939,7 +939,7 @@
939939
</ReturnValue>
940940
<Docs>
941941
<summary>Gets a value indicating whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
942-
<value>true if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, false.</value>
942+
<value><see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread-safe); otherwise, <see langword="false" />.</value>
943943
<remarks>To be added.</remarks>
944944
</Docs>
945945
</Member>
@@ -1142,7 +1142,7 @@
11421142
</ReturnValue>
11431143
<Docs>
11441144
<summary>Gets a value indicating whether the <see cref="T:System.Collections.IDictionary" /> object has a fixed size.</summary>
1145-
<value>true if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, false.</value>
1145+
<value><see langword="true" /> if the <see cref="T:System.Collections.IDictionary" /> object has a fixed size; otherwise, <see langword="false" />.</value>
11461146
<remarks>To be added.</remarks>
11471147
</Docs>
11481148
</Member>
@@ -1169,7 +1169,7 @@
11691169
</ReturnValue>
11701170
<Docs>
11711171
<summary>Gets a value indicating whether the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only.</summary>
1172-
<value>true if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, false.</value>
1172+
<value><see langword="true" /> if the <see cref="T:System.Collections.Generic.ICollection`1" /> is read-only; otherwise, <see langword="false" />.</value>
11731173
<remarks>To be added.</remarks>
11741174
</Docs>
11751175
</Member>
@@ -1793,4 +1793,4 @@
17931793
</Docs>
17941794
</Member>
17951795
</Members>
1796-
</Type>
1796+
</Type>

xml/System.Collections.Immutable/ImmutableSortedSet`1+Builder.xml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -784,7 +784,7 @@
784784
<ReturnType>System.Boolean</ReturnType>
785785
</ReturnValue>
786786
<Docs>
787-
<summary>Gets a value indicating whether this instance is read-only.</summary>
787+
<summary>Gets a value that indicates whether this instance is read-only.</summary>
788788
<value>Always <c>false</c>.</value>
789789
<remarks>To be added.</remarks>
790790
</Docs>
@@ -887,8 +887,8 @@
887887
<ReturnType>System.Boolean</ReturnType>
888888
</ReturnValue>
889889
<Docs>
890-
<summary>Gets a value indicating whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe).</summary>
891-
<value>true if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, false.</value>
890+
<summary>Gets a value that indicates whether access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread-safe).</summary>
891+
<value><see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread-safe); otherwise, <see langword="false" />.</value>
892892
<remarks>To be added.</remarks>
893893
</Docs>
894894
</Member>
@@ -1021,4 +1021,4 @@
10211021
</Docs>
10221022
</Member>
10231023
</Members>
1024-
</Type>
1024+
</Type>

0 commit comments

Comments
 (0)