Skip to content

Commit a15eaf7

Browse files
authored
link to the latest version of Framework Design Guidelines (dotnet#86216)
also added Jeremy Barton because he was inconsistently mentioned
1 parent fa2f0fd commit a15eaf7

File tree

3 files changed

+8
-5
lines changed

3 files changed

+8
-5
lines changed

docs/coding-guidelines/api-guidelines/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22

33
The guidelines in this folder represent work in progress API design guidelines.
44
The official guidelines can be found in the [documentation][docs] and as an
5-
actual [book].
5+
actual [book][FDG].
66

77
## Process
88

99
To submit new proposals for design guidelines, simply create a PR adding or
1010
modifying an existing file.
1111

1212
[docs]: https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/
13-
[book]: https://amazon.com/dp/0321545613
13+
[FDG]: https://amazon.com/dp/0135896460

docs/coding-guidelines/framework-design-guidelines-digest.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ Framework Design Guidelines - Digest
33

44
This page is a distillation and a simplification of the most basic
55
guidelines described in detail in a book titled
6-
[Framework Design Guidelines][FDG] by Krzysztof Cwalina and Brad Abrams.
6+
[Framework Design Guidelines][FDG] by Krzysztof Cwalina, Jeremy Barton and Brad
7+
Abrams.
78

89
Framework Design Guidelines were created in the early days of .NET Framework
910
development. They started as a small set of naming and design conventions but
@@ -12,7 +13,7 @@ considered the canonical way to design frameworks at Microsoft. They carry the
1213
experience and cumulative wisdom of thousands of developer hours over several
1314
versions of the .NET Framework.
1415

15-
[FDG]: http://amazon.com/dp/0321545613
16+
[FDG]: https://amazon.com/dp/0135896460
1617

1718
# General Design Principles
1819

docs/project/api-review-process.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -77,10 +77,12 @@ If you want to collaborate with other people on the design, feel free to perform
7777

7878
## API Design Guidelines
7979

80-
The .NET design guidelines are captured in the famous book [Framework Design Guidelines](https://www.amazon.com/dp/0135896460) by Krzysztof Cwalina, Jeremy Barton and Brad Abrams.
80+
The .NET design guidelines are captured in the famous book [Framework Design Guidelines][FDG] by Krzysztof Cwalina, Jeremy Barton and Brad Abrams.
8181

8282
A digest with the most important guidelines are available in our [documentation](../coding-guidelines/framework-design-guidelines-digest.md). Long term, we'd like to publish the individual guidelines in standalone repo on which we can also accept PRs and -- more importantly for API reviews -- link to.
8383

84+
[FDG]: https://amazon.com/dp/0135896460
85+
8486
## API Review Notes
8587

8688
The API review notes are being published in [API Review repository](https://github.com/dotnet/apireviews).

0 commit comments

Comments
 (0)