You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+12-5Lines changed: 12 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -82,15 +82,22 @@ Your pull request should:
82
82
* To avoid line ending issues, set `autocrlf = input` and `whitespace = cr-at-eol` in your git configuration
83
83
84
84
## Contributing `lib.d.ts` fixes
85
-
86
-
The library sources are in: [src/lib](https://github.com/Microsoft/TypeScript/tree/master/src/lib)
87
85
88
-
Library files in `built/local/` are updated by running
89
-
```Shell
86
+
There are three relevant locations to be aware of when it comes to TypeScript's library declaration files:
87
+
88
+
*`src/lib`: the location of the sources themselves.
89
+
*`lib`: the location of the last-known-good (LKG) versions of the files which are updated periodically.
90
+
*`built/local`: the build output location, including where `src/lib` files will be copied to.
91
+
92
+
Any changes should be made to [src/lib](https://github.com/Microsoft/TypeScript/tree/master/src/lib). **Most** of these files can be updated by hand, with the exception of any generated files (see below).
93
+
94
+
Library files in `built/local/` are updated automatically by running the standard build task:
95
+
96
+
```sh
90
97
jake
91
98
```
92
99
93
-
**Note**: The files in `lib/` are used to bootstrap compilation and usually do not need to be updated.
100
+
The files in `lib/` are used to bootstrap compilation and usually **should not**be updated unless publishing a new version or updating the LKG.
0 commit comments