Skip to content
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

[About > Releases] page translation #74

Merged
merged 2 commits into from
Jul 26, 2024
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
60 changes: 30 additions & 30 deletions src/about/releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,67 +13,67 @@ onMounted(async () => {
})
</script>

# Releases {#releases}
# Wydania {#releases}

<p v-if="version">
The current latest stable version of Vue is <strong>{{ version }}</strong>.
Aktualnie najnowsza stabilna wersja Vue to <strong>{{ version }}</strong>.
</p>
<p v-else>
Checking latest version...
Sprawdzanie najnowszej wersji...
</p>

A full changelog of past releases is available on [GitHub](https://github.com/vuejs/core/blob/main/CHANGELOG.md).
Pełny changelog poprzednich wydań jest dostępny na [GitHub](https://github.com/vuejs/core/blob/main/CHANGELOG.md).

## Release Cycle {#release-cycle}
## Cykl wydań {#release-cycle}

Vue does not have a fixed release cycle.
Vue nie ma ustalonego cyklu wydań.

- Patch releases are released as needed.
- Wydania poprawkowe (patch releases) są wydawane w razie potrzeby.

- Minor releases always contain new features, with a typical time frame of 3~6 months in between. Minor releases always go through a beta pre-release phase.
- Wydania mniejsze (minor releases) zawsze zawierają nowe funkcje, a typowy czas pomiędzy nimi wynosi 3-6 miesięcy. Mniejsze wydania zawsze przechodzą przez fazę beta.

- Major releases will be announced ahead of time, and will go through an early discussion phase and alpha / beta pre-release phases.
- Wydania główne (major releases) będą ogłaszane z wyprzedzeniem i przejdą przez wczesną fazę dyskusji oraz fazy alpha/beta.

## Semantic Versioning Edge Cases {#semantic-versioning-edge-cases}
## Przypadki brzegowe wersjonowania semantycznego {#semantic-versioning-edge-cases}

Vue releases follow [Semantic Versioning](https://semver.org/) with a few edge cases.
Wydania Vue są zgodne z [wersjonowaniem semantycznym](https://semver.org/), jednak istnieje kilka przypadków brzegowych.

### TypeScript Definitions {#typescript-definitions}
### Definicje TypeScript {#typescript-definitions}

We may ship incompatible changes to TypeScript definitions between **minor** versions. This is because:
Możemy dostarczać niekompatybilne zmiany w definicjach TypeScript między wersjami **mniejszymi**. Dzieje się tak, ponieważ:

1. Sometimes TypeScript itself ships incompatible changes between minor versions, and we may have to adjust types to support newer versions of TypeScript.
1. Czasami sam TypeScript wprowadza niekompatybilne zmiany między wersjami mniejszymi, co zmusza nas do dostosowania typów, aby wspierać nowsze wersje TypeScript.

2. Occasionally we may need to adopt features that are only available in a newer version of TypeScript, raising the minimum required version of TypeScript.
2. Sporadycznie musimy przyjąć funkcje, które są dostępne tylko w nowszej wersji TypeScript, co podnosi minimalną wymaganą wersję TypeScript.

If you are using TypeScript, you can use a semver range that locks the current minor and manually upgrade when a new minor version of Vue is released.
Jeśli używasz TypeScript'a, możesz użyć zakresu semver, który blokuje obecną wersję mniejszą, i ręcznie aktualizować, gdy zostanie wydana nowa mniejsza wersja Vue.

### Compiled Code Compatibility with Older Runtime {#compiled-code-compatibility-with-older-runtime}
### Zgodność skompilowanego kodu ze starszym środowiskiem wykonawczym{#compiled-code-compatibility-with-older-runtime}

A newer **minor** version of Vue compiler may generate code that isn't compatible with the Vue runtime from an older minor version. For example, code generated by Vue 3.2 compiler may not be fully compatible if consumed by the runtime from Vue 3.1.
Nowsza **mniejsza** wersja kompilatora Vue może generować kod, który nie jest zgodny z środowiskiem wykonawczym Vue ze starszej wersji mniejszej. Na przykład, kod wygenerowany przez kompilator Vue 3.2 może nie być w pełni kompatybilny, jeśli jest używany przez środowisko wykonawcze z Vue 3.1.

This is only a concern for library authors, because in applications, the compiler version and the runtime version is always the same. A version mismatch can only happen if you ship pre-compiled Vue component code as a package, and a consumer uses it in a project using an older version of Vue. As a result, your package may need to explicitly declare a minimum required minor version of Vue.
Jest to problem tylko dla autorów bibliotek, ponieważ w aplikacjach wersja kompilatora i wersja środowiska wykonawczego są zawsze takie same. Niezgodność wersji może wystąpić tylko wtedy, gdy dostarczasz skompilowany kod komponentu Vue jako paczkę, a użytkownik używa go w projekcie z starszą wersją Vue. W rezultacie paczka może wymagać jawnego zadeklarowania minimalnej wymaganej mniejszej wersji Vue.

## Pre Releases {#pre-releases}
## Wstępne wydania {#pre-releases}

Minor releases typically go through a non-fixed number of beta releases. Major releases will go through an alpha phase and a beta phase.
Wydania mniejsze zazwyczaj przechodzą przez nieustaloną liczbę wersji beta. Wydania główne przechodzą przez fazę alpha i fazę beta.

Additionally, we publish canary releases every week from the `main` and `minor` branches on GitHub. They are published as different packages to avoid bloating the npm metadata of the stable channel. You can install them via `npx install-vue@canary` or `npx install-vue@canary-minor`, respectively.
Dodatkowo, co tydzień publikujemy wydania canary z `głównych` i `mniejszych` gałęzi na GitHubie. Są one publikowane jako różne paczki, aby uniknąć obciążania metadanych npm na stabilnym kanale. Możesz je zainstalować za pomocą `npx install-vue@canary` lub `npx install-vue@canary-minor`.

Pre-releases are meant for integration / stability testing, and for early adopters to provide feedback for unstable features. Do not use pre-releases in production. All pre-releases are considered unstable and may ship breaking changes in between, so always pin to exact versions when using pre-releases.
Wstępne wydania są przeznaczone do testowania integracji / stabilności oraz dla wczesnych użytkowników, którzy chcą dostarczyć opinii na temat niestabilnych funkcji. Nie używaj wstępnych wydań w produkcji. Wszystkie wstępne wydania są uznawane za niestabilne i mogą zawierać zmiany, które mogą powodować problemy, więc zawsze przypinaj się do dokładnych wersji podczas używania wstępnych wydań.

## Deprecations {#deprecations}
## Ustępstwa {#deprecations}

We may periodically deprecate features that have new, better replacements in minor releases. Deprecated features will continue to work, and will be removed in the next major release after it entered deprecated status.
Okresowo możemy wycofywać funkcje, które mają nowe, lepsze zamienniki w wydaniach mniejszych. Funkcje oznaczone jako przestarzałe będą nadal działać i zostaną usunięte w następnym głównym wydaniu po ich oznaczeniu jako przestarzałe.

## RFCs {#rfcs}

New features with substantial API surface and major changes to Vue will go through the **Request for Comments** (RFC) process. The RFC process is intended to provide a consistent and controlled path for new features to enter the framework, and give the users an opportunity to participate and offer feedback in the design process.
Nowe funkcje z dużą powierzchnią API oraz istotne zmiany w Vue przechodzą przez proces **Request for Comments** (RFC). Proces RFC ma na celu zapewnienie spójnej i kontrolowanej ścieżki dla wprowadzania nowych funkcji do frameworka oraz umożliwienie użytkownikom udziału i wyrażania opinii w procesie projektowania.

The RFC process is conducted in the [vuejs/rfcs](https://github.com/vuejs/rfcs) repo on GitHub.
Proces RFC jest prowadzony w repozytorium [vuejs/rfcs](https://github.com/vuejs/rfcs) na GitHubie.

## Experimental Features {#experimental-features}
## Funkcje eksperymentalne {#experimental-features}

Some features are shipped and documented in a stable version of Vue, but marked as experimental. Experimental features are typically features that have an associated RFC discussion with most of the design problems resolved on paper, but still lacking feedback from real-world usage.
Niektóre funkcje są dostarczane i dokumentowane w stabilnej wersji Vue, ale oznaczone jako eksperymentalne. Funkcje eksperymentalne to zazwyczaj funkcje, które mają odpowiednią dyskusję RFC z większością problemów projektowych rozwiązanych teoretycznie, ale wciąż brakuje im opinii z rzeczywistego użytkowania.

The goal of experimental features is to allow users to provide feedback for them by testing them in a production setting, without having to use an unstable version of Vue. Experimental features themselves are considered unstable, and should only be used in a controlled manner, with the expectation that the feature may change between any release types.
Celem funkcji eksperymentalnych jest umożliwienie użytkownikom przekazywania opinii na ich temat poprzez testowanie ich w środowisku produkcyjnym, bez konieczności używania niestabilnej wersji Vue. Same funkcje eksperymentalne są uważane za niestabilne i powinny być używane w kontrolowany sposób, z oczekiwaniem, że funkcja może się zmienić pomiędzy różnymi typami wydań.