Skip to content

Commit

Permalink
Update deprecation schedule in README (DefinitelyTyped#50561)
Browse files Browse the repository at this point in the history
* Update deprecation schedule in README

* update missed text in Russian readme
  • Loading branch information
sandersn authored Jan 12, 2021
1 parent e89f7d9 commit 384445a
Show file tree
Hide file tree
Showing 7 changed files with 32 additions and 18 deletions.
6 changes: 4 additions & 2 deletions README.cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,9 @@ npm install --save-dev @types/node
这通常会在 `package.json` 文件中的 `"types"``"typings"` 字段中提供,
或者可以只查找包中的任何 ".d.ts" 文件并手动将它们包含在 `/// <reference path="" />`.

#### 旧版本的 TypeScript(3.1 和更早版本)
#### 旧版本的 TypeScript(3.3 和更早版本)

Definitely Typed 仅在小于 2 年的 TypeScript 版本上测试软件包。当前已测试 3.2 及更高版本。如果您使用的是 TypeScript 2.0 到 3.1,仍然可以尝试安装 @types 软件包,大多数软件包都不使用 TypeScript 的新特性。但是不能保证它们会起作用,这是支持窗口:
Definitely Typed 仅在小于 2 年的 TypeScript 版本上测试软件包。当前已测试 3.4 及更高版本。如果您使用的是 TypeScript 2.0 到 3.3,仍然可以尝试安装 @types 软件包,大多数软件包都不使用 TypeScript 的新特性。但是不能保证它们会起作用,这是支持窗口:

Version | Released | End of Support
-- | -- | --
Expand All @@ -89,6 +89,8 @@ Version | Released | End of Support
3.8 | February 2020 | February 2022
3.9 | May 2020 | May 2022
4.0 | August 2020 | August 2022
4.1 | November 2020 | November 2022
4.2 | February 2021 | February 2023

`@types` 软件包具有它们明确支持的 TypeScript 版本的标记,因此通常可以获取早于 2 年窗口的较早版本的软件包。例如,如果运行 `npm dist-tags @types/react`,您将看到 TypeScript 2.5 可以将类型用于 react@16.0,而 TypeScript 2.6 和 2.7 可以将类型用于 react@16.4:

Expand Down
6 changes: 4 additions & 2 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,10 +52,10 @@ Si aún no puedes encontrarlo, comprueba si el paquete ya [incluye](http://www.t
Esto es provisto usualmente en el campo `"types"` o `"typings"` en el `package.json`,
o solo busca por cualquier archivo ".d.ts" en el paquete e inclúyelo manualmente con un `/// <reference path="" />`.

#### Versiones más viejas de TypeScript (3.1 y anteriores)
#### Versiones más viejas de TypeScript (3.3 y anteriores)

Definitely Typed solamente prueba paquetes en versiones de TypeScript que son menores a 2 años.
Actualmente, las versiones 3.2 y posteriores están siendo probadas. Si estas usando TypeScript 2.0 a 3.1, puedes intentar instalando paquetes `@types` &mdash; la mayoría de los paquetes no usan los beneficios de Typescript más nuevos. No hay garantía de que funcionen.
Actualmente, las versiones 3.4 y posteriores están siendo probadas. Si estas usando TypeScript 2.0 a 3.3, puedes intentar instalando paquetes `@types` &mdash; la mayoría de los paquetes no usan los beneficios de Typescript más nuevos. No hay garantía de que funcionen.
Versiones soportadas:

Versión | Liberado | Fin de soporte
Expand All @@ -73,6 +73,8 @@ Versión | Liberado | Fin de soporte
3.8 | Febrero 2020 | Febrero 2022
3.9 | Mayo 2020 | Mayo 2022
4.0 | Agosto 2020 | Agosto 2022
4.1 | Noviembre 2020 | Noviembre 2022
4.2 | Febrero 2021 | Febrero 2023

Los paquetes `@types` tienen etiquetas para las versiones de Typescript que explícitamente soportan, usualmente puedes obtener versiones más viejas de los paquetes anteriores a 2 años.
Por ejemplo, si ejecutas `npm dist-tags @types/react`, observaras que Typescript 2.5 puede usar types para react@16.0, a su vez, Typescript 2.6 y 2.7 pueden usar types para react@16.4.
Expand Down
8 changes: 5 additions & 3 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,11 +71,11 @@ npm install --save-dev @types/node
大抵は `package.json``"types"` フィールドや `"typings"` フィールドに指定されています。
もしくは、パッケージ内の各 ".d.ts" ファイルを確認し、 `/// <reference path="" />` を使って手動でインクルードしてください。

#### 古いバージョンの TypeScript (3.1 以前)
#### 古いバージョンの TypeScript (3.3 以前)

Definitely Typed では、リリースから2年以内のバージョンの TypeScript 上でのみパッケージのテストを実施しています。
現時点ではバージョン 3.2 以上でテストされています。
TypeScript 2.0 ~ 3.1 を使用している場合、引き続き `@types` パッケージをインストールすることは可能です &mdash; これは TypeScript の最新機能を使用しているパッケージがそんなに多くないためです。
現時点ではバージョン 3.4 以上でテストされています。
TypeScript 2.0 ~ 3.3 を使用している場合、引き続き `@types` パッケージをインストールすることは可能です &mdash; これは TypeScript の最新機能を使用しているパッケージがそんなに多くないためです。
ただし、正常に動作する保証もありません。
サポート期間については下記のとおりです。

Expand All @@ -94,6 +94,8 @@ TypeScript 2.0 ~ 3.1 を使用している場合、引き続き `@types` パ
| 3.8 | 2020年2月 | 2022年2月 |
| 3.9 | 2020年5月 | 2022年5月 |
| 4.0 | 2020年8月 | 2022年8月 |
| 4.1 | 2020年11月 | 2022年11月 |
| 4.2 | 2021年2月 | 2023年2月 |

`@types` パッケージには、サポートする TypeScript のバージョンを明示的に指定するタグがあるため、多くの場合はサポート期間外のバージョン用のパッケージでも入手できます。
たとえば、 `npm dist-tags @types/react` を実行すると、 TypeScript 2.5 なら react@16.0 の、 TypeScript 2.6 や 2.7 なら react@16.4 の型定義がそれぞれ利用できることが確認できます。
Expand Down
8 changes: 5 additions & 3 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,11 +75,11 @@ npm 의 "foo" 패키지에 대응되는 자료형 패키지는 "@types/foo" 입
이 경우 주로 `package.json` 파일의 `"types"``"typings"` 필드(Field)를 통해 제공되지만,
`/// <reference path="" />` 같은 주석을 사용하여 패키지 안의 ".d.ts" 파일들을 직접 가져와야 할 수도 있습니다.

#### 이전 버전 TypeScript (3.1 또는 그 이전)
#### 이전 버전 TypeScript (3.3 또는 그 이전)

Definitely Typed는 2년이 지나지 않은 TypeScript 버전만을 대상으로 패키지를 테스트합니다.
현재 버전 3.2 및 그 이상만을 테스트하고 있습니다.
TypeScript 2.0에서 3.1 버전을 사용하는 경우, 그래도 `@types` 패키지를 한번 설치해 보셔도 무방합니다. 최신 TypeScript 기능을 사용하는 패키지는 그리 많지 않으니까요.
현재 버전 3.4 및 그 이상만을 테스트하고 있습니다.
TypeScript 2.0에서 3.3 버전을 사용하는 경우, 그래도 `@types` 패키지를 한번 설치해 보셔도 무방합니다. 최신 TypeScript 기능을 사용하는 패키지는 그리 많지 않으니까요.
그러나 작동 여부를 보장하지는 못합니다.
지원 기간은 다음과 같습니다:

Expand All @@ -98,6 +98,8 @@ TypeScript 2.0에서 3.1 버전을 사용하는 경우, 그래도 `@types` 패
3.8 | 2020년 2월 | 2022년 2월
3.9 | 2020년 5월 | 2022년 5월
4.0 | 2020년 8월 | 2022년 8월
4.1 | 2020년 11월 | 2022년 11월
4.2 | 2021년 2월 | 2023년 2월

`@types` 패키지 안에는 패키지가 확실하게 지원하는 TypeScript 버전이 태그로 쓰여 있으므로, 2년 지원 기간이 지난 오래된 패키지도 보통 찾아보실 수 있습니다.
예를 들어, `npm dist-tags @types/react` 명령어를 입력하면 TypeScript 2.5는 react@16.0용 타입을, TypeScript 2.6 및 2.7은 react@16.4용 타입을 사용할 수 있는 것을 확인하실 수 있습니다:
Expand Down
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,11 +71,11 @@ If you still can't find it, check if it [bundles](http://www.typescriptlang.org/
This is usually provided in a `"types"` or `"typings"` field in the `package.json`,
or just look for any ".d.ts" files in the package and manually include them with a `/// <reference path="" />`.

#### Older versions of TypeScript (3.1 and earlier)
#### Older versions of TypeScript (3.3 and earlier)

Definitely Typed only tests packages on versions of TypeScript that are less than 2 years old.
Currently versions 3.2 and above are tested.
If you're using TypeScript 2.0 to 3.1, you can still try installing `@types` packages &mdash; the majority of packages don't use fancy new TypeScript features.
Currently versions 3.4 and above are tested.
If you're using TypeScript 2.0 to 3.3, you can still try installing `@types` packages &mdash; the majority of packages don't use fancy new TypeScript features.
But there's no guarantee that they'll work.
Here is the support window:

Expand All @@ -94,6 +94,8 @@ Here is the support window:
| 3.8 | February 2020 | February 2022 |
| 3.9 | May 2020 | May 2022 |
| 4.0 | August 2020 | August 2022 |
| 4.1 | November 2020 | November 2022 |
| 4.2 | February 2021 | February 2023 |

`@types` packages have tags for versions of TypeScript that they explicitly support, so you can usually get older versions of packages that predate the 2-year window.
For example, if you run `npm dist-tags @types/react`, you'll see that TypeScript 2.5 can use types for react@16.0, whereas TypeScript 2.6 and 2.7 can use types for react@16.4:
Expand Down
8 changes: 5 additions & 3 deletions README.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,11 +73,11 @@ Se você mesmo assim não consegue achar o pacote, verifique se ele [inclui](htt
Isso normalmente é informado nos campos `"types"` ou `"typings"` no `package.json`,
ou apenas procure por qualquer arquivo ".d.ts" no pacote e manualmente inclua-os com `/// <reference path="" />`.

#### Versões antigas do TypeScript (3.1 e anteriores)
#### Versões antigas do TypeScript (3.3 e anteriores)

O Definitely Typed testa apenas pacotes em versões do TypeScript que tenham sido lançadas a menos de 2 anos.
Atualmente, as versões 3.2 e acima são testadas.
Se você está usando as versões 2.0 a 3.1 do TypeScript, você ainda pode tentar instalar os pacotes `@types` &mdash; a maioria dos pacotes não usam as novas funcionalidades chiques do TypeScript.
Atualmente, as versões 3.4 e acima são testadas.
Se você está usando as versões 2.0 a 3.3 do TypeScript, você ainda pode tentar instalar os pacotes `@types` &mdash; a maioria dos pacotes não usam as novas funcionalidades chiques do TypeScript.
Mas não tem nenhuma garantia de que elas funcionarão.
Esta é a tabela de duração de suporte das versões.

Expand All @@ -96,6 +96,8 @@ Versão | Lançada em | Término do suporte
3.8 | Fevereiro 2020 | Fevereiro 2022
3.9 | Maio 2020 | Maio 2022
4.0 | Agosto 2020 | Agosto 2022
4.1 | Novembro 2020 | Novembro 2022
4.2 | Fevereiro 2021 | Fevereiro 2023

Pacotes `@types` têm tags para versões do TypeScript que elas explicitamente suportam, então normalmente você pode usar versões mais antigas dos pacotes que precedem o período de 2 anos.
Por exemplo, se você executar o comando `npm dist-tags @types/react`, você verá que o TypeScript 2.5 pode usar os tipos para o react@16.0, enquanto o TypeScript 2.6 e 2.7 podem usar os tipos para o react@16.4:
Expand Down
6 changes: 4 additions & 2 deletions README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,10 +73,10 @@ npm install --save-dev @types/node
Если вы все еще не можете найти его, проверьте [включает](https://www.typescriptlang.org/docs/handbook/declaration-files/publishing.html) ли пакет собственную типизацию.
Обычно это отражается в поле `"types"` или `"typings"` файла `package.json`, или просто ищите любые файлы «.d.ts» в пакете и вручную включайте их с помощью `/// <reference path="" />`.

#### TypeScript 3.1 и старее
#### TypeScript 3.3 и старее

Начиная с ноября 2019 года, Definitely Typed тестирует пакеты только на версиях Typescript, которым меньше двух лет.
Если вы используете Typescript от 2.0 до 3.1, вы все равно можете попробовать установить пакеты `@types` - большинство пакетов не используют новые функции Typescript.
Если вы используете Typescript от 2.0 до 3.3, вы все равно можете попробовать установить пакеты `@types` - большинство пакетов не используют новые функции Typescript.
Но нет гарантии, что они будут работать.

График обновлений:
Expand All @@ -96,6 +96,8 @@ npm install --save-dev @types/node
3.8 | Февраль 2020 | Февраль 2022
3.9 | Май 2020 | Май 2022
4.0 | Август 2020 | Август 2022
4.1 | Ноябрь 2020 | Ноябрь 2022
4.2 | Февраль 2021 | Февраль 2023


Пакеты, которые существовали до ноября 2019 года, могут иметь более старые версии, которые явно помечены как совместимые с более старыми версиями Typescript; используйте тег "ts2.6" для Typescript 2.6, например.
Expand Down

0 comments on commit 384445a

Please sign in to comment.