Skip to content

Handbook -> Docs, i18n doc pages, Double nesting #790

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 14 commits into from
Jul 25, 2020
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ typings/
dist

.lighthouserc.json
packages/handbook-v1/output/attribution.json
packages/documentation/output/attribution.json

.yarn/cache
.yarn/unplugged
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ yarn workspace tsconfig-reference run generate-json
yarn workspace tsconfig-reference run generate-markdown
```

Validate the docs
Validate the docs:

```sh
yarn workspace tsconfig-reference run test
Expand All @@ -82,7 +82,7 @@ yarn workspace tsconfig-reference run lint
yarn workspace tsconfig-reference run lint resolveJson
```

## Handbook V1
## Documentation

The docs for TypeScript. Originally ported over from [microsoft/TypeScript-Handbook](https://github.com/microsoft/TypeScript-Handbook/) then intermingled with [microsoft/TypeScript-New-Handbook](https://github.com/microsoft/TypeScript-New-Handbook), and finally updated for [Twoslash](http://www.staging-typescript.org/dev/twoslash/) and with new content.

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"packages/ts-twoslasher",
"packages/gatsby-remark-shiki-twoslash",
"packages/community-meta",
"packages/handbook-v1",
"packages/documentation",
"packages/handbook-epub",
"packages/sandbox",
"packages/playground",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: TypeScript for Functional Programmers
short: TS for Functional Programmers
layout: docs
permalink: /docs/handbook/typescript-in-5-minutes-func.html
oneline: Learn TypeScript if you have a background in functional programming
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: TypeScript for JavaScript Programmers
short: TypeScript for JS Programmers
layout: docs
permalink: /docs/handbook/typescript-in-5-minutes.html
oneline: Learn how TypeScript extends JavaScript
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: TypeScript for Java/C# Programmers
short: TS for Java/C# Programmers
layout: docs
permalink: /docs/handbook/typescript-in-5-minutes-oop.html
oneline: Learn TypeScript if you have a background in object-oriented languages
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: TypeScript for the New Programmer
short: TS for the New Programmer
layout: docs
permalink: /docs/handbook/typescript-from-scratch.html
oneline: Learn TypeScript from scratch
Expand All @@ -26,9 +27,9 @@ The "run anywhere" nature of JS makes it an attractive choice for cross-platform
There are many developers these days that use _only_ JavaScript to program their entire stack!

To summarize, we have a language that was designed for quick uses, and then grew to a full-fledged tool to write applications with millions of lines.
Every language has its own _quirks_ — oddities and surprises, and JavaScript's humble beginning makes it have _many_ of these. Some examples:
Every language has its own _quirks_ — oddities and surprises, and JavaScript's humble beginning makes it have _many_ of these. Some examples:

* JavaScript's equality operator (`==`) _coerces_ its arguments, leading to unexpected behavior:
- JavaScript's equality operator (`==`) _coerces_ its arguments, leading to unexpected behavior:

```js
if ("" == 0) {
Expand All @@ -39,7 +40,7 @@ Every language has its own _quirks_ — oddities and surprises, and JavaScript's
}
```

* JavaScript also allows accessing properties which aren't present:
- JavaScript also allows accessing properties which aren't present:

```js
const obj = { width: 10, height: 15 };
Expand Down Expand Up @@ -137,6 +138,7 @@ The bottom line is that while you might see type errors during compilation, the

Finally, TypeScript doesn't provide any additional runtime libraries.
Your programs will use the same standard library (or external libraries) as JavaScript programs, so there's no additional TypeScript-specific framework to learn.

<!--
Should extend this paragraph to say that there's an exception of
allowing you to use newer JS features and transpile the code to an older
Expand Down
File renamed without changes.
Loading