Skip to content

Translate parts of Release Channels #150

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 3 commits into from
Dec 10, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 44 additions & 44 deletions content/docs/release-channels.md
Original file line number Diff line number Diff line change
@@ -1,95 +1,95 @@
---
id: release-channels
title: Release Channels
title: Buraxılış Kanalları
permalink: docs/release-channels.html
layout: docs
category: installation
---

React relies on a thriving open source community to file bug reports, open pull requests, and [submit RFCs](https://github.com/reactjs/rfcs). To encourage feedback we sometimes share special builds of React that include unreleased features.
React, çiçəklənən open source cəmiyyətinin göndərdiyi baq hesabatlarına, açdığı pull request-lərə və [təqdim etdiyi RFC-lərə](https://github.com/reactjs/rfcs) arxalanır. Rəyləri təşviq etmək üçün biz buraxılmamış xüsusiyyətlər üçün React-in xüsusi qurulmalarını paylaşırıq.

> This document will be most relevant to developers who work on frameworks, libraries, or developer tooling. Developers who use React primarily to build user-facing applications should not need to worry about our prerelease channels.
> Bu sənəddə olan məlumatlar freymvorklar, kitabxanalar və digər developer alətləri üzərində işləyən proqramçılar üçün daha uyğundur. İstifadəçilər üçün applikasiyalar yazan proqramçılar bizim ön buraxılış kanallarımızda baş verən problemlərdən narahat olmamalıdırlar.

Each of React's release channels is designed for a distinct use case:
React-in hər buraxılış kanalı xüsusi ssenari üçün dizayn olunub:

- [**Latest**](#latest-channel) is for stable, semver React releases. It's what you get when you install React from npm. This is the channel you're already using today. **Use this for all user-facing React applications.**
- [**Next**](#next-channel) tracks the master branch of the React source code repository. Think of these as release candidates for the next minor semver release. Use this for integration testing between React and third party projects.
- [**Experimental**](#experimental-channel) includes experimental APIs and features that aren't available in the stable releases. These also track the master branch, but with additional feature flags turned on. Use this to try out upcoming features before they are released.
- [**Latest**](#latest-channel) (Ən Yeni) kanalı React-in stabil, semver buraxılışları üçün işlədilir. React-i NPM-dən yüklədikdə bu kanalda olan qurulmanı əldə edirsiniz. Siz bugünki gündə bu kanaldan istifadə edirsiniz. **İstifadəçilər üçün applikasiyalar yazdıqda bu kanaldan istifadə edin.**
- [**Next**](#next-channel) (Sonrakı) kanalı React kod reposunun master qolunu izləyir. Bu kanalda olan buraxılışların sonrakı kiçik semver buraxılışı üçün buraxılış kandidatı olduğunu fikirləşin. React və 3-cü tərəfin layihələrinin arasında inteqrasiya testi etmək üçün bu kanaldan istifadə edin.
- [**Experimental**](#experimental-channel) (Eksperimental) kanalında stabil buraxılışlarda olmayan eksperimental API-lar və xüsusiyyətlər mövcuddur. Bu kanalın buraxılışları da master qolunu izləyirlər. Lakin, bu kanalda olan buraxılışlarda əlavə xüsusiyyət nişanları yandırılıb. Qarşıda gələn xüsusiyyətləri buraxılmamışdan öncə yoxlamaq üçün bu kanaldan istifadə edin.

All releases are published to npm, but only Latest uses [semantic versioning](/docs/faq-versioning.html). Prereleases (those in the Next and Experimental channels) have versions generated from a hash of their contents, e.g. `0.0.0-1022ee0ec` for Next and `0.0.0-experimental-1022ee0ec` for Experimental.
Bütün buraxılışların NPM-ə dərc olunmasına baxmayaraq yalnız Latest kanalının buraxılışları [semantik versiyalama](/docs/faq-versioning.html) qaydalarından istifadə edirlər. Ön buraxılışların (Next Experimental kanallarında olan) versiyaları kontentin həşindən yaranırlar. Məsələn, Next buraxılışı `0.0.0-1022ee0ec` formada, Experimental buraxılışı isə `0.0.0-experimental-1022ee0ec` formada versiyalanır.

**The only officially supported release channel for user-facing applications is Latest**. Next and Experimental releases are provided for testing purposes only, and we provide no guarantees that behavior won't change between releases. They do not follow the semver protocol that we use for releases from Latest.
**Latest kanalı istifadəçilər üçün yazılmış applikasiyaları dəstəkləyən tək rəsmi buraxılış kanalıdır**. Next Experimental buraxılışları test etmə üçün təmin edilir. Bu buraxılışlar arasında davranışların dəyişməyəcəyinə heç bir siğorta yoxdur. Biz bu buraxılışlarda Latest kanalında olan buraxılışlar üçün işlətdiyimiz semver protokulundən istifadə etmirik.

By publishing prereleases to the same registry that we use for stable releases, we are able to take advantage of the many tools that support the npm workflow, like [unpkg](https://unpkg.com) and [CodeSandbox](https://codesandbox.io).
Stabil buraxılışlar üçün istifadə etdiyimiz registry-yə ön buraxılışları dərc edərək NPM iş axınını dəstəkləyən bir çox alətdən ([unpkg](https://unpkg.com) [CodeSandbox](https://codesandbox.io) kimi) istifadə edə bilirik.

### Latest Channel {#latest-channel}
### Latest Kanalı {#latest-channel}

Latest is the channel used for stable React releases. It corresponds to the `latest` tag on npm. It is the recommended channel for all React apps that are shipped to real users.
Latest Kanal React-in stabil buraxılışları üçün istifadə edilir. Bu kanal, NPM-də olan `latest` təqə uyğundur. Real istifadəçilər üçün dərc edilən React applikasiyaları üçün bu kanaldan istifadə etməyi tövsiyyə edirik.

**If you're not sure which channel you should use, it's Latest.** If you're a React developer, this is what you're already using.
**Əgər hansı kanaldan istifadə edəcəyinizi bilmirsinizsə, Latest kanalından istifadə edin.** Əgər React proqramçısınızsa, siz artıq bu kanaldan istifadə edirsiniz.

You can expect updates to Latest to be extremely stable. Versions follow the semantic versioning scheme. Learn more about our commitment to stability and incremental migration in our [versioning policy](/docs/faq-versioning.html).
Latest kanalında dərc olunan yeniliklərin son dərəcədə stabil olacağını gözləyə bilərsiniz. Bu kanalda olan buraxılışlar semantik versiya sxemini izləyirlər. Bizim stabillik və inkremental miqrasiya üçün öhdəmiz haqqında əlavə məlumat almaq üçün [versiya qaydaları](/docs/faq-versioning.html) sənədini oxuyun.

### Next Channel {#next-channel}
### Next Kanalı {#next-channel}

The Next channel is a prerelease channel that tracks the master branch of the React repository. We use prereleases in the Next channel as release candidates for the Latest channel. You can think of Next as a superset of Latest that is updated more frequently.
Next Kanalı React reposunun master qolunu izləyən ön buraxılış kanalıdır. Biz, Next kanalında olan ön buraxılışları Latest kanalı üçün buraxılış kandidatları kimi işlədirik. Next kanalının Latest kanalının superset-i olduğunu və tez-tez yeniləndiyini fikirləşin.

The degree of change between the most recent Next release and the most recent Latest release is approximately the same as you would find between two minor semver releases. However, **the Next channel does not conform to semantic versioning.** You should expect occasional breaking changes between successive releases in the Next channel.
Next və Latest kanallarının ən yeni buraxılışları arasında olan fərqin dərəcəsi iki kiçik semver buraxılışının arasında olan fərqin dərəcəsinə bərabərdir. Lakin, **Next kanalı semantik versiyalama sxemindən istifadə etmir.** Next kanalında olan ardıcıl buraxılışlar arasında sına bilən dəyişikliklərin olacağını gözləyin.

**Do not use prereleases in user-facing applications.**
**Ön buraxılışları istifadəçi applikasiyalarında istifadə etməyin.**

Releases in Next are published with the `next` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-1022ee0ec`.
Next buraxılışları NPM-də `next` təqi ilə dərc olunurlar. Bu buraxılışların versiyaları qurulma kontentinin həşi əsasında yaranır. Məsələn, `0.0.0-1022ee0ec`.

#### Using the Next Channel for Integration Testing {#using-the-next-channel-for-integration-testing}
#### Next Kanalının İnteqrasiya Testi üçün İstifadəsi {#using-the-next-channel-for-integration-testing}

The Next channel is designed to support integration testing between React and other projects.
Next kanalı React və digər layihələr arasında inteqrasiya testlərini dəstəkləmək üçün dizayn olunub.

All changes to React go through extensive internal testing before they are released to the public. However, there are a myriad of environments and configurations used throughout the React ecosystem, and it's not possible for us to test against every single one.
React-də olan bütün dəyişikliklər, dərc olunmadan öncə geniş daxili test etmədən keçirlər. Lakin, React ekosistemində çoxlu mühit və konfiqurasiyaların olduğundan biz bunların hamısını test edə bilmirik.

If you're the author of a third party React framework, library, developer tool, or similar infrastructure-type project, you can help us keep React stable for your users and the entire React community by periodically running your test suite against the most recent changes. If you're interested, follow these steps:
Əgər siz 3-cü tərəfin React freymvorkunun, kitabxanasının və ya oxşar infrasuktur tipli layihəsinin müəllifisinizsə, siz test dəstinizi React-in ən yeni dəyişiklikləri ilə icra edərək bizə React-i sizin istifadəçiləriniz üçün stabil saxlamağa kömək edə bilərsiniz. Əgər maraqlanırsınızsa, aşağıdakı addımları təqib edin:

- Set up a cron job using your preferred continuous integration platform. Cron jobs are supported by both [CircleCI](https://circleci.com/docs/2.0/triggers/#scheduled-builds) and [Travis CI](https://docs.travis-ci.com/user/cron-jobs/).
- In the cron job, update your React packages to the most recent React release in the Next channel, using `next` tag on npm. Using the npm cli:
- Üstünlük verdiyiniz continuous inteqration platformunda cron iş quraşdırın. Cron işlər [CircleCI](https://circleci.com/docs/2.0/triggers/#scheduled-builds) [Travis CI](https://docs.travis-ci.com/user/cron-jobs/) platformalarında dəstəklənirlər.
- Cron işində, NPM-də `next` təqindən istifadə edərək React paketlərini Next kanalında olan ən yeni buraxılış ilə yeniləyin. NPM ilə:

```
npm update react@next react-dom@next
```

Or yarn:
Yarn ilə:

```
yarn upgrade react@next react-dom@next
```
- Run your test suite against the updated packages.
- If everything passes, great! You can expect that your project will work with the next minor React release.
- If something breaks unexpectedly, please let us know by [filing an issue](https://github.com/facebook/react/issues).
- Test dəstinizi yenilənən paketlər ilə icra edin.
- Əgər testlər keçdisə, əla! Layihənizin React-in sonrakı kiçik versiyası ilə işləyəcəyindən əmin ola bilərsiniz.
- Nəsə sındıqda, [issue yaradaraq](https://github.com/facebook/react/issues) bizə xəbər verin.

A project that uses this workflow is Next.js. (No pun intended! Seriously!) You can refer to their [CircleCI configuration](https://github.com/zeit/next.js/blob/c0a1c0f93966fe33edd93fb53e5fafb0dcd80a9e/.circleci/config.yml) as an example.
Bu iş axınını işlədən layihələrdən biri Next.js-dir. Nümunə kimi, bu layihənin [CircleCI konfiqurasiyasına](https://github.com/zeit/next.js/blob/c0a1c0f93966fe33edd93fb53e5fafb0dcd80a9e/.circleci/config.yml) baxa bilərsiniz.

### Experimental Channel {#experimental-channel}
### Experimental Kanalı {#experimental-channel}

Like Next, the Experimental channel is a prerelease channel that tracks the master branch of the React repository. Unlike Next, Experimental releases include additional features and APIs that are not ready for wider release.
Next kanalında olduğu kimi Experimental kanalı da React reposunun master qolunu izləyən ön buraxılış kanalıdır. Lakin Next-dən fərqli olaraq Experimental buraxılışlarda geniş buraxılış üçün hazır olmayan əlavə xüsusiyyətlər və API-lar mövcuddur.

Usually, an update to Next is accompanied by a corresponding update to Experimental. They are based on the same source revision, but are built using a different set of feature flags.
Adətən, Next-ə edilən yeniliyə müvafiq Experimental yenilik də edilir. Bu yeniliklər eyni kod tətfişi əsasındadır. Lakin, bu buraxılışlar fərqli xüsusiyyət nişanları ilə qurulurlar.

Experimental releases may be significantly different than releases to Next and Latest. **Do not use Experimental releases in user-facing applications.** You should expect frequent breaking changes between releases in the Experimental channel.
Experimental buraxılışlar Next və Latest buraxılışlarından tam fərqli ola bilərlər. **İstifadəçilər üçün applikasiyalarda Experimental buraxılışlardan istifadə etməyin.** Experimental kanalın buraxılışları arasında tez-tez sınan dəyişiklərinin olacağını gözləyin.

Releases in Experimental are published with the `experimental` tag on npm. Versions are generated from a hash of the build's contents, e.g. `0.0.0-experimental-1022ee0ec`.
Experimental buraxılışlar NPM-də `experimental` təqi ilə dərc olunurlar. Bu buraxılışların versiyaları qurulma kontentinin həşi əsasında yaranır. Məsələn, `0.0.0-experimental-1022ee0ec`.

#### What Goes Into an Experimental Release? {#what-goes-into-an-experimental-release}
#### Experimental Buraxılışına Nələr Daxildir? {#what-goes-into-an-experimental-release}

Experimental features are ones that are not ready to be released to the wider public, and may change drastically before they are finalized. Some experiments may never be finalized -- the reason we have experiments is to test the viability of proposed changes.
Hamı üçün dərc olunmağa hazır olmayan və yekunlaşana kimi kəskin dəyişə bilən xüsusiyyətlər eksperimentaldır. Bəzi eksperimentlər heç vaxt yekunlaşmaya bilər. Eksperimentlərin olmasının səbəbi təklif edilən dəyişikliklərin canlılığının yoxlanılmasıdır.

For example, if the Experimental channel had existed when we announced Hooks, we would have released Hooks to the Experimental channel weeks before they were available in Latest.
Məsələn, Hooklar elan ediləndə eksperimental kanal olsa idi, bu xüsusiyyət Latest kanalında olmaqdan həftələrlə öncə Experimental kanalında dərc olunacaqdı.

You may find it valuable to run integration tests against Experimental. This is up to you. However, be advised that Experimental is even less stable than Next. **We do not guarantee any stability between Experimental releases.**
Sizin üçün experimental kanala qarşı inteqrasiya testlərini icra etmək faydalı ola bilər. Bu sizdən asılıdır. Lakin, Experimental buraxılışların Next buraxılışlarından daha da az stabil olduğunu unutmayın. **Biz Experimental buraxılışlar arasında heç bir stabilliyi siğortalamırıq.**

#### How Can I Learn More About Experimental Features? {#how-can-i-learn-more-about-experimental-features}
#### Eksperimental Xüsusiyyətlər Haqqında Haradan Öyrənə Bilərəm? {#how-can-i-learn-more-about-experimental-features}

Experimental features may or may not be documented. Usually, experiments aren't documented until they are close to shipping in Next or Stable.
Eksperimental xüsusiyyətlər sənədləşmiş olmaya bilərlər. Adətən, eksperimentlər Next və ya Latest kanallarına daxil olmayana kimi sənədləşmirlər.

If a feature is not documented, they may be accompanied by an [RFC](https://github.com/reactjs/rfcs).
Əgər xüsusiyyət sənədləşməyibsə, bu xüsusiyyətin [RFC-si](https://github.com/reactjs/rfcs) ola bilər.

We will post to the [React blog](/blog) when we're ready to announce new experiments, but that doesn't mean we will publicize every experiment.
Yeni eksperimentləri elan etməyə hazır olduqda biz bunları [React bloqunda](/blog) dərc edəcəyik. Lakin, bu demək deyil ki, biz hər eksperimenti elan edəcəyik.

You can always refer to our public GitHub repository's [history](https://github.com/facebook/react/commits/master) for a comprehensive list of changes.
Dəyişikliklərin əhatəli siyahısını görmək üçün bizim ictimati GitHub repomuzun [tarixinə](https://github.com/facebook/react/commits/master) istinad edə bilərsiniz.