diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3368eca..903273b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
+### Changed
+- Update and improvement of Polish translation from [@m-aciek](https://github.com/m-aciek).
## [1.0.0] - 2017-06-20
### Added
diff --git a/config.rb b/config.rb
index de6daf1..578e0ab 100644
--- a/config.rb
+++ b/config.rb
@@ -5,7 +5,7 @@
# ----- Site ----- #
# Last version should be the latest English version since the manifesto is first
# written in English, then translated into other languages later.
-$versions = (Dir.entries("source/en") - %w[. ..])
+$versions = (Dir.entries("source/en").sort - %w[. ..])
$last_version = $versions.last
$previous_version = $versions[$versions.index($last_version) - 1]
@@ -107,7 +107,7 @@ redirect "index.html", to: "en/#{$last_version}/index.html"
$languages.each do |language|
code = language.first
- versions = Dir.entries("source/#{code}") - %w[. ..]
+ versions = Dir.entries("source/#{code}").sort - %w[. ..]
redirect "#{code}/index.html", to: "#{code}/#{versions.last}/index.html"
end
diff --git a/source/pl/1.0.0/index.html.haml b/source/pl/1.0.0/index.html.haml
index c5f0cf1..d428770 100644
--- a/source/pl/1.0.0/index.html.haml
+++ b/source/pl/1.0.0/index.html.haml
@@ -33,7 +33,8 @@ version: 1.0.0
Czym jest changelog?
%p
Changelog, inaczej rejestr zmian, to plik zawierający utrzymywaną,
- chronologicznie uporządkowaną listę istotnych zmian dla każdej wersji projektu.
+ uporządkowaną chronologicznie, listę istotnych zmian dla każdej wersji
+ projektu.
%h3#why
%a.anchor{ href: "#why", aria_hidden: "true" }
@@ -70,34 +71,34 @@ version: 1.0.0
%li
Wersje i sekcje powinny być linkowalne.
%li
- Najnowsza wersja jest na pierwszym miejscu.
+ Najnowsza wersja na pierwszym miejscu.
%li
- Wyszczególniona jest data wydania każdej wersji.
+ Wyszczególniona data wydania każdej wersji.
%li
- Wzmianka, czy przestrzegasz #{link_to "wersjonowania semantycznego", semver}.
+ Wzmianka, czy przestrzegacie #{link_to "wersjonowania semantycznego", semver}.
%a.anchor{ href: "#types", aria_hidden: "true" }
%h4#types Typy zmian
%ul
%li
- %code Added
+ %code Dodane
dla nowych funkcjonalności.
%li
- %code Changed
+ %code Zmienione
dla zmian w istniejących funkcjonalnościach.
%li
- %code Deprecated
+ %code Zdezaprobowane
dla funkcjonalności wkrótce do usunięcia.
%li
- %code Removed
- dla teraz usuniętych funkcjonalności.
+ %code Usunięte
+ dla teraz usuwanych funkcjonalności.
%li
- %code Fixed
+ %code Naprawione
dla jakichkolwiek poprawek błędów.
%li
- %code Security
- w przypadku luk w zabezpieczeniach.
+ %code Bezpieczeństwo
+ w przypadku luk w zabezpieczeniach.
.effort
@@ -105,16 +106,17 @@ version: 1.0.0
%a.anchor{ href: "#effort", aria_hidden: "true" }
Jak mogę zminimalizować wysiłek wkładany w prowadzenie changelogu?
%p
- Prowadź sekcję Unreleased
na szczycie dokumentu, aby śledzić
+ Prowadź sekcję Niewydane
na szczycie dokumentu, aby śledzić
nadchodzące zmiany.
%p Ta praktyka ma dwa cele:
%ul
%li
- Ludzie widzą, jakich zmian mogą się spodziewać w nadchodzących wydaniach.
+ Ludzie widzą, jakich zmian mogą się spodziewać w nadchodzących
+ wydaniach.
%li
- W momencie wydania możesz przenieść zmiany z sekcji Unreleased
+ W momencie wydania możesz przenieść zmiany z sekcji Niewydane
do sekcji nowego wydania.
.bad-practices
@@ -129,32 +131,33 @@ version: 1.0.0
Zmiany w commit logu
%p
- Używanie zmian w commit logach jako changelogów jest złym pomysłem: są pełne
- szumu. Rzeczy takich jak merge commity, commity z niejasnymi tytułami,
- zmiany w dokumentacji itp.
+ Używanie zmian w commit logach jako changelogów jest złym pomysłem: commit
+ logi są pełne szumu: rzeczy takich jak merge commity, commity z niejasnymi
+ tytułami, zmiany w dokumentacji itp.
%p
- Zadaniem commita jest udokumentowanie kroku w ewolucji kodu źródłowego.
+ Zadaniem commita jest udokumentowanie kroku w ewolucji kodu źródłowego.
Niektóre projekty porządkują commity, niektóre nie.
%p
Zadaniem wpisu w changelogu jest udokumentowanie zmian godnych odnotowania,
- często składających się z wielu commitów, aby przedstawić je jasno
+ często składających się z wielu commitów, aby przedstawić je jasno
użytkownikom końcowym.
%h4#ignoring-deprecations
%a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" }
- Ignorowanie deprecjacji
+ Ignorowanie dezaprobowań
%p
- Gdy ludzie robią upgrade z jednej wersji na drugą, powinno być bezboleśnie
- jasne kiedy coś się złamie. Powinno być możliwe upgrade'owanie się do wersji,
- która wypisuje deprecjacje, usunięcie tego, co jest zdezaprobowane, następnie
- upgrade'owanie się do wersji, w której deprecjacje stają się usunięciami.
+ Gdy ludzie robią upgrade z jednej wersji do drugiej, powinno być bezboleśnie
+ jasne kiedy coś się może zepsuć. Powinno być możliwe upgrade'owanie się do
+ wersji, która wypisuje zdezaprobowania, usunięcie tego, co jest
+ zdezaprobowane, następnie upgrade'owanie się do wersji, w której
+ dezaprobowane funkcjonalności są usuwane.
%p
- Jeśli nie robisz nic więcej, wypisz deprecjacje, usunięcia i jakiekolwiek
- zmiany łamiące zgodność wstecz w swoim changelogu.
+ Jeśli nie robisz nic innego, wypisz w swoim changelogu zdezaprobowania,
+ usunięcia i jakiekolwiek zmiany łamiące zgodność wstecz.
%h4#confusing-dates
%a.anchor{ href: "#confusing-dates", aria_hidden: "true" }
@@ -163,13 +166,13 @@ version: 1.0.0
%p
Regionalne formaty dat różnią się na świecie i często trudno jest znaleźć
przyjazny człowiekowi format daty, który wydaje się intuicyjny wszystkim.
- Zaletą dat sformatowanych jak 2017-07-17
jest to, że są one
+ Zaletą dat sformatowanych tak jak 2017-07-17
jest to, że są one
uporządkowane od największych do najmniejszych jednostek: roku, miesiąca
i dnia. Ten format również nie nachodzi w niejednoznaczny sposób na inne
formaty dat, w przeciwieństwie do niektórych regionalnych formatów, które
zamieniają miejsce numerów miesiąca i dnia. Z tych powodów i faktu, że
- ten format daty jest #({link_to "standardem ISO", iso}, wynika rekomendacja
- tego formatu daty do wpisów w changelogu.
+ ten format daty jest #{link_to "standardem ISO", iso}, wynika rekomendacja
+ tego formatu daty do wpisów w changelogu.
%aside
Jest tego więcej. Pomóż mi zebrać te antywzorce
@@ -192,7 +195,8 @@ version: 1.0.0
%p
Ten projekt pretenduje do bycia
= link_to "lepszą konwencją changelogu.", changelog
- Pochodzi z obserwowania dobrych praktyk w społeczności open source i zebrania ich.
+ Pochodzi z obserwowania i zebrania dobrych praktyk w społeczności open
+ source.
%p
Zdrowa krytyka, dyskusja i sugestie poprawek
@@ -209,8 +213,8 @@ version: 1.0.0
%p
Łatwo jest uznać, że nazwa pliku z changelogiem nie ma większego znaczenia,
- lecz po co utrudniać swoim końcowym użytkownikom w sposób konsewenty
- odnajdować istotne zmiany?
+ lecz po co utrudniać swoim użytkownikom końcowym odnajdowanie w sposób
+ konsekwentny istotnych zmian?
%h4#github-releases
%a.anchor{ href: "#github-releases", aria_hidden: "true" }
@@ -220,7 +224,7 @@ version: 1.0.0
To wspaniała inicjatywa. #{link_to "Releases", ghr} mogą być używane do
zmiany prostych tagów Gita (na przykład taga nazwanego v1.0.0
)
w bogate informacje o wydaniach przez ręczne dodanie informacji lub mogą
- wyciągać oznaczone message taga i przekształcać je w informacje.
+ wyciągać oznaczone message tagów i przekształcać je w informacje.
%p
GitHub Releases tworzą nieprzenośny changelog, który może być prezentowany
@@ -228,7 +232,7 @@ version: 1.0.0
formatu Prowadź changelog, ale będzie to dość skomplikowane.
%p
- Bieżąca wersja wydań GitHub jest też prawdopodobnie nie najłatwiejsza do
+ Bieżąca wersja wydań GitHub jest też prawdopodobnie nienajłatwiejsza do
odnalezienia dla użytkowników końcowych, w przeciwieństwie do plików
o nazwach z wielkimi literami (README
, CONTRIBUTING
itp.). Innym mniejszym brakiem jest to, że interfejs obecnie nie posiada
@@ -256,10 +260,10 @@ version: 1.0.0
poważnego błędu lub problemów z bezpieczeństwem. Często te wersje nie
pojawiają się w dziennikach zmian. Powinny. Tak powinieneś je wyświetlać:
- %p ## 0.0.5 - 2014-12-13 [YANKED]
+ %p ## 0.0.5 - 2014-12-13 [WYCOFANA]
%p
- Etykieta [YANKED]
jest celowo zapisany wielkimi literami.
+ Etykieta [WYCOFANA]
jest celowo zapisana wielkimi literami.
Ważne jest, by zwracano na nią uwagę. Jest otoczona nawiasami, więc jest
również prostsza do sparsowania przez skrypt.
@@ -284,15 +288,15 @@ version: 1.0.0
Jak mogę wnieść swój wkład?
%p
- Ten dokument nie jest obiektywną **prawdą**; jest moją starannie przemyślaną
- opinią, z informacjami i przykładami, które zebrałem.
+ Ten dokument nie jest obiektywną prawdą; jest moją
+ starannie przemyślaną opinią, z informacjami i przykładami, które zebrałem.
%p
To dlatego, że chcę, aby nasza społeczność osiągnęła konsensus. Wierzę, że
dyskusja jest tak samo istotna jak efekt końcowy.
%p
- Więc proszę, #{link_to "zabieraj się za robotę", gh}.
+ Więc proszę, #{link_to "wtrąć się", gh}.
.press
%h3 Rozmowy