Skip to content

Commit

Permalink
🤖 Merge PR DefinitelyTyped#66942 Remove prose from READMEs which hard…
Browse files Browse the repository at this point in the history
…code the minimum supported TS by @jakebailey
  • Loading branch information
jakebailey authored Oct 18, 2023
1 parent 1df6ab1 commit 02c9098
Show file tree
Hide file tree
Showing 9 changed files with 43 additions and 58 deletions.
10 changes: 5 additions & 5 deletions README.es.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,15 +32,14 @@ Si aún no puedes encontrarlo, comprueba si el paquete ya [incluye](https://www.
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 (4.0 y anteriores)

Definitely Typed solamente prueba paquetes en versiones de TypeScript que son menores a 2 años.
Actualmente, las versiones 4.1 y posteriores están siendo probadas. Si estas usando TypeScript 2.0 a 4.0, 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:
### Support window

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Versiones más viejas de TypeScript</summary>

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 All @@ -62,6 +61,7 @@ Por ejemplo, si ejecutas `npm dist-tags @types/react`, observaras que Typescript

Tal vez debas añadir manualmente las [referencias](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html).

</details>

## ¿Cómo puedo contribuir?

Expand Down
10 changes: 3 additions & 7 deletions README.fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,16 +52,12 @@ Si vous ne trouvez toujours pas les typages, recherchez simplement les fichiers

Definitely Typed ne teste que les paquets sur des versions de TypeScript datant de moins de 2 ans.

<details>
<summary>Actuellement, les versions 4.1 et supérieures sont testées...</summary>

Si vous utilisez TypeScript 2.0 à 4.0, vous pouvez toujours essayer d'installer les paquets `@types` &mdash ; la majorité des paquets n'utilisent pas les nouvelles fonctionnalités fantaisistes de TypeScript.
Mais rien ne garantit qu'ils fonctionneront.
Voici le support de version:

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Anciennes versions de TypeScript</summary>

Les paquets `@types` ont des étiquettes pour les versions de TypeScript qu'ils supportent explicitement, de sorte que vous pouvez généralement obtenir des versions plus anciennes de paquets qui précèdent la fenêtre de 2 ans.
Par exemple, si vous lancez `npm dist-tags @types/react`, vous verrez que TypeScript 2.5 peut utiliser les types pour react@16.0, alors que TypeScript 2.6 et 2.7 peuvent utiliser les types pour react@16.4 :

Expand Down
11 changes: 6 additions & 5 deletions README.it.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,17 +49,16 @@ Se ancora non riesci a trovarlo, vuol dire che sono [inclusi](https://www.typesc
Di solito vengono specificati nel campo `"types"` o `"typings"` nel `package.json`;
oppure prova a cercare per dei file ".d.ts" nel package ed includerli manualmente con `/// <reference path="" />`.

#### Vecchie versioni di TypeScript (4.0 e precedenti)
### Support window

"Definitely Typed" testa packages solo su versioni di TypeScript che hanno meno di due anni.
Attualmente vengono testate le versioni 4.1 e successive.
Se stai usando una versione di TypeScript tra 2.0 e la 4.0, puoi ancora provare ad installare i package `@types`, in quanto la maggior parte di questi non usano le funzionalità più all'avanguardia di Typescript.
Non c'è comunque nessuna garanzia che funzioneranno.
Di seguito la finestra di supporto per ogni versione di TypeScript:

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Versioni precedenti di TypeScript</summary>

I package `@types` hanno dei tag per indicare le specifiche versioni di TypeScript che supportano, quindi di solito puoi installare versioni precedenti di package seppur precedenti alla finestra dei due anni.
Ad esempio se esegui `npm dist-tags @types/react`, vedrai che TypeScript 2.5 potrà usare i tipi per react@16.0, mentre TypeScript 2.6 e 2.7 potranno usare i tipi per react@16.4:

Expand All @@ -81,6 +80,8 @@ Ad esempio se esegui `npm dist-tags @types/react`, vedrai che TypeScript 2.5 pot

Potresti dover aggiungere manualmente le [reference](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html).

</details>

## Come posso contribuire?

"Definitely Typed" deve il suo successo e la sua funzionalità solo grazie a contributori come te!
Expand Down
13 changes: 6 additions & 7 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,17 +47,14 @@ npm install --save-dev @types/node
大抵は `package.json``"types"` フィールドや `"typings"` フィールドに指定されています。
もしくは、パッケージ内の各 ".d.ts" ファイルを確認し、 `/// <reference path="" />` を使って手動でインクルードしてください。

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

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

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>古いバージョンの TypeScript</summary>

`@types` パッケージには、サポートする TypeScript のバージョンを明示的に指定するタグがあるため、多くの場合はサポート期間外のバージョン用のパッケージでも入手できます。
たとえば、 `npm dist-tags @types/react` を実行すると、 TypeScript 2.5 なら react@16.0 の、 TypeScript 2.6 や 2.7 なら react@16.4 の型定義がそれぞれ利用できることが確認できます。

Expand All @@ -79,6 +76,8 @@ TypeScript 2.0 ~ 4.0 を使用している場合、引き続き `@types` パ

手動で[リファレンス](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html)を追加する必要があります。

</details>

## コントリビュート(貢献)する方法

Definitely Typed は、あなたのようなユーザーによるコントリビュート(貢献)のおかげで成り立っています!
Expand Down
12 changes: 5 additions & 7 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,17 +51,14 @@ npm 의 "foo" 패키지에 대응되는 자료형 패키지는 "@types/foo" 입
이 경우 주로 `package.json` 파일의 `"types"``"typings"` 필드(Field)를 통해 제공되지만,
`/// <reference path="" />` 같은 주석을 사용하여 패키지 안의 ".d.ts" 파일들을 직접 가져와야 할 수도 있습니다.

#### 이전 버전 TypeScript (4.0 또는 그 이전)

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

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>이전 버전 TypeScript</summary>

`@types` 패키지 안에는 패키지가 확실하게 지원하는 TypeScript 버전이 태그로 쓰여 있으므로, 2년 지원 기간이 지난 오래된 패키지도 보통 찾아보실 수 있습니다.
예를 들어, `npm dist-tags @types/react` 명령어를 입력하면 TypeScript 2.5는 react@16.0용 타입을, TypeScript 2.6 및 2.7은 react@16.4용 타입을 사용할 수 있는 것을 확인하실 수 있습니다:

Expand All @@ -83,6 +80,7 @@ TypeScript 2.0에서 4.0 버전을 사용하는 경우, 그래도 `@types` 패

위 방법을 사용할 경우 수동으로 [참조(Reference)](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html)를 추가해주어야 할 수 있습니다.

</details>

## 어떻게 기여하나요?

Expand Down
10 changes: 3 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,16 +56,12 @@ If you still can't find the typings, just look for any ".d.ts" files in the pack

Definitely Typed only tests packages on versions of TypeScript that are less than 2 years old.

<details>
<summary>Currently versions 4.1 and above are tested...</summary>

If you're using TypeScript 2.0 to 4.0, 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:

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Older versions of TypeScript</summary>

`@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
13 changes: 6 additions & 7 deletions README.pt.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,17 +52,14 @@ 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 (4.0 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 4.1 e acima são testadas.
Se você está usando as versões 2.0 a 4.0 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.
### Support window

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Versões antigas do TypeScript</summary>

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 All @@ -85,6 +82,8 @@ Por exemplo, se você executar o comando `npm dist-tags @types/react`, você ver

Talvez você precise adicionar [referências](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html) manuais.

</details>

## Como eu posso contribuir?

O Definitely Typed só funciona por causa de contribuições de usuários como você!
Expand Down
13 changes: 6 additions & 7 deletions README.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,17 +49,14 @@ 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 4.0 и старее

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

График обновлений:
### Support window

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Older versions of TypeScript</summary>

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

Например, если вы запустите `npm dist-tags @types/react`, вы увидите следующую таблицу, которая показывает, что у react@16.4 есть типы для Typescript 2.6:
Expand All @@ -80,6 +77,8 @@ npm install --save-dev @types/node

Возможно, вам придется добавить ручные [ссылки (references)](https://www.typescriptlang.org/docs/handbook/triple-slash-directives.html).

</details>

## Как я могу внести свой вклад?

Definitely Typed работает только благодаря вкладу таких пользователей, как вы!
Expand Down
9 changes: 3 additions & 6 deletions README.zh-Hans.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,15 +50,12 @@ npm install --save-dev @types/node

Definitely Typed 仅在发布时间小于 2 年的 TypeScript 版本上测试软件包。

<details>
<summary>当前,已测试 4.1 及更高版本……</summary>

你如果使用 TypeScript 2.0 至 4.0 版本,那么仍可以尝试安装 `@types` 软件包——因为其中大多数都没有使用 TypeScript 的新功能,然而,我们无法保证它们可以正常工作。
支持周期如下所示:

<img src="docs/support-window.svg#gh-light-mode-only" style="width:100%">
<img src="docs/support-window.svg#gh-dark-mode-only" style="width:100%">

<details>
<summary>Older versions of TypeScript</summary>

`@types` 软件包在标签种列出了其明确支持的 TypeScript 版本,因此你常常可以取得大于 2 年支持周期的软件包旧版本。
例如,若运行 `npm dist-tags @types/react`,你将看到 TypeScript 2.5 可使用 react@16.0 的类型定义,而 TypeScript 2.6 和 2.7 则可使用 react@16.4:

Expand Down

0 comments on commit 02c9098

Please sign in to comment.