Merge pull request #250 from m-aciek/master

Polish translation improvements, link bugfix, added line to changelog…
This commit is contained in:
Olivier Lacan 2018-09-04 12:08:40 -04:00 committed by GitHub
commit f13f59b79d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 48 additions and 42 deletions

View File

@ -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). and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased] ## [Unreleased]
### Changed
- Update and improvement of Polish translation from [@m-aciek](https://github.com/m-aciek).
## [1.0.0] - 2017-06-20 ## [1.0.0] - 2017-06-20
### Added ### Added

View File

@ -5,7 +5,7 @@
# ----- Site ----- # # ----- Site ----- #
# Last version should be the latest English version since the manifesto is first # Last version should be the latest English version since the manifesto is first
# written in English, then translated into other languages later. # 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 $last_version = $versions.last
$previous_version = $versions[$versions.index($last_version) - 1] $previous_version = $versions[$versions.index($last_version) - 1]
@ -110,7 +110,7 @@ redirect "index.html", to: "en/#{$last_version}/index.html"
$languages.each do |language| $languages.each do |language|
code = language.first 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" redirect "#{code}/index.html", to: "#{code}/#{versions.last}/index.html"
end end

View File

@ -33,7 +33,8 @@ version: 1.0.0
Czym jest changelog? Czym jest changelog?
%p %p
Changelog, inaczej rejestr zmian, to plik zawierający utrzymywaną, 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 %h3#why
%a.anchor{ href: "#why", aria_hidden: "true" } %a.anchor{ href: "#why", aria_hidden: "true" }
@ -70,34 +71,34 @@ version: 1.0.0
%li %li
Wersje i sekcje powinny być linkowalne. Wersje i sekcje powinny być linkowalne.
%li %li
Najnowsza wersja jest na pierwszym miejscu. Najnowsza wersja na pierwszym miejscu.
%li %li
Wyszczególniona jest data wydania każdej wersji. Wyszczególniona data wydania każdej wersji.
%li %li
Wzmianka, czy przestrzegasz #{link_to "wersjonowania semantycznego", semver}. Wzmianka, czy przestrzegacie #{link_to "wersjonowania semantycznego", semver}.
%a.anchor{ href: "#types", aria_hidden: "true" } %a.anchor{ href: "#types", aria_hidden: "true" }
%h4#types Typy zmian %h4#types Typy zmian
%ul %ul
%li %li
%code Added %code Dodane
dla nowych funkcjonalności. dla nowych funkcjonalności.
%li %li
%code Changed %code Zmienione
dla zmian w istniejących funkcjonalnościach. dla zmian w istniejących funkcjonalnościach.
%li %li
%code Deprecated %code Zdezaprobowane
dla funkcjonalności wkrótce do usunięcia. dla funkcjonalności wkrótce do usunięcia.
%li %li
%code Removed %code Usunięte
dla teraz usuniętych funkcjonalności. dla teraz usuwanych funkcjonalności.
%li %li
%code Fixed %code Naprawione
dla jakichkolwiek poprawek błędów. dla jakichkolwiek poprawek błędów.
%li %li
%code Security %code Bezpieczeństwo
w przypadku luk w zabezpieczeniach. w przypadku luk w zabezpieczeniach.
.effort .effort
@ -105,16 +106,17 @@ version: 1.0.0
%a.anchor{ href: "#effort", aria_hidden: "true" } %a.anchor{ href: "#effort", aria_hidden: "true" }
Jak mogę zminimalizować wysiłek wkładany w prowadzenie changelogu? Jak mogę zminimalizować wysiłek wkładany w prowadzenie changelogu?
%p %p
Prowadź sekcję <code>Unreleased</code> na szczycie dokumentu, aby śledzić Prowadź sekcję <code>Niewydane</code> na szczycie dokumentu, aby śledzić
nadchodzące zmiany. nadchodzące zmiany.
%p Ta praktyka ma dwa cele: %p Ta praktyka ma dwa cele:
%ul %ul
%li %li
Ludzie widzą, jakich zmian mogą się spodziewać w nadchodzących wydaniach. Ludzie widzą, jakich zmian mogą się spodziewać w&nbsp;nadchodzących
wydaniach.
%li %li
W momencie wydania możesz przenieść zmiany z sekcji <code>Unreleased</code> W momencie wydania możesz przenieść zmiany z sekcji <code>Niewydane</code>
do sekcji nowego wydania. do sekcji nowego wydania.
.bad-practices .bad-practices
@ -129,32 +131,33 @@ version: 1.0.0
Zmiany w commit logu Zmiany w commit logu
%p %p
Używanie zmian w commit logach jako changelogów jest złym pomysłem: są pełne Używanie zmian w commit logach jako changelogów jest złym pomysłem: commit
szumu. Rzeczy takich jak merge commity, commity z niejasnymi tytułami, logi są pełne szumu: rzeczy takich jak merge commity, commity z niejasnymi
zmiany w dokumentacji itp. tytułami, zmiany w&nbsp;dokumentacji itp.
%p %p
Zadaniem commita jest udokumentowanie kroku w ewolucji kodu źródłowego. Zadaniem commita jest udokumentowanie kroku w&nbsp;ewolucji kodu źródłowego.
Niektóre projekty porządkują commity, niektóre nie. Niektóre projekty porządkują commity, niektóre nie.
%p %p
Zadaniem wpisu w changelogu jest udokumentowanie zmian godnych odnotowania, 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&nbsp;wielu commitów, aby przedstawić je jasno
użytkownikom końcowym. użytkownikom końcowym.
%h4#ignoring-deprecations %h4#ignoring-deprecations
%a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" } %a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" }
Ignorowanie deprecjacji Ignorowanie dezaprobowań
%p %p
Gdy ludzie robią upgrade z jednej wersji na drugą, powinno być bezboleśnie Gdy ludzie robią upgrade z jednej wersji do drugiej, powinno być bezboleśnie
jasne kiedy coś się złamie. Powinno być możliwe upgrade'owanie się do wersji, jasne kiedy coś się może zepsuć. Powinno być możliwe upgrade'owanie się do
która wypisuje deprecjacje, usunięcie tego, co jest zdezaprobowane, następnie wersji, która wypisuje zdezaprobowania, usunięcie tego, co jest
upgrade'owanie się do wersji, w której deprecjacje stają się usunięciami. zdezaprobowane, następnie upgrade'owanie się do wersji, w której
dezaprobowane funkcjonalności są usuwane.
%p %p
Jeśli nie robisz nic więcej, wypisz deprecjacje, usunięcia i jakiekolwiek Jeśli nie robisz nic innego, wypisz w swoim changelogu zdezaprobowania,
zmiany łamiące zgodność wstecz w swoim changelogu. usunięcia i&nbsp;jakiekolwiek zmiany łamiące zgodność wstecz.
%h4#confusing-dates %h4#confusing-dates
%a.anchor{ href: "#confusing-dates", aria_hidden: "true" } %a.anchor{ href: "#confusing-dates", aria_hidden: "true" }
@ -163,13 +166,13 @@ version: 1.0.0
%p %p
Regionalne formaty dat różnią się na świecie i często trudno jest znaleźć 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. przyjazny człowiekowi format daty, który wydaje się intuicyjny wszystkim.
Zaletą dat sformatowanych jak <code>2017-07-17</code> jest to, że są one Zaletą dat sformatowanych tak jak <code>2017-07-17</code> jest to, że są one
uporządkowane od największych do najmniejszych jednostek: roku, miesiąca 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 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 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 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 ten format daty jest #{link_to "standardem ISO", iso}, wynika rekomendacja
tego formatu daty do wpisów w changelogu. tego formatu daty do wpisów w&nbsp;changelogu.
%aside %aside
Jest tego więcej. Pomóż mi zebrać te antywzorce Jest tego więcej. Pomóż mi zebrać te antywzorce
@ -192,7 +195,8 @@ version: 1.0.0
%p %p
Ten projekt pretenduje do bycia Ten projekt pretenduje do bycia
= link_to "lepszą konwencją changelogu.", changelog = 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 %p
Zdrowa krytyka, dyskusja i sugestie poprawek Zdrowa krytyka, dyskusja i sugestie poprawek
@ -209,8 +213,8 @@ version: 1.0.0
%p %p
Łatwo jest uznać, że nazwa pliku z changelogiem nie ma większego znaczenia, Ł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 lecz po co utrudniać swoim użytkownikom końcowym odnajdowanie w sposób
odnajdować istotne zmiany? konsekwentny istotnych zmian?
%h4#github-releases %h4#github-releases
%a.anchor{ href: "#github-releases", aria_hidden: "true" } %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 To wspaniała inicjatywa. #{link_to "Releases", ghr} mogą być używane do
zmiany prostych tagów Gita (na przykład taga nazwanego <code>v1.0.0</code>) zmiany prostych tagów Gita (na przykład taga nazwanego <code>v1.0.0</code>)
w bogate informacje o wydaniach przez ręczne dodanie informacji lub mogą 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 %p
GitHub Releases tworzą nieprzenośny changelog, który może być prezentowany 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. formatu Prowadź changelog, ale będzie to dość skomplikowane.
%p %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 odnalezienia dla użytkowników końcowych, w przeciwieństwie do plików
o nazwach z wielkimi literami (<code>README</code>, <code>CONTRIBUTING</code> o nazwach z wielkimi literami (<code>README</code>, <code>CONTRIBUTING</code>
itp.). Innym mniejszym brakiem jest to, że interfejs obecnie nie posiada 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 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ć: pojawiają się w dziennikach zmian. Powinny. Tak powinieneś je wyświetlać:
%p <code>## 0.0.5 - 2014-12-13 [YANKED]</code> %p <code>## 0.0.5 - 2014-12-13 [WYCOFANA]</code>
%p %p
Etykieta <code>[YANKED]</code> jest celowo zapisany wielkimi literami. Etykieta <code>[WYCOFANA]</code> jest celowo zapisana wielkimi literami.
Ważne jest, by zwracano na nią uwagę. Jest otoczona nawiasami, więc jest Ważne jest, by zwracano na nią uwagę. Jest otoczona nawiasami, więc jest
również prostsza do sparsowania przez skrypt. również prostsza do sparsowania przez skrypt.
@ -284,15 +288,15 @@ version: 1.0.0
Jak mogę wnieść swój wkład? Jak mogę wnieść swój wkład?
%p %p
Ten dokument nie jest obiektywną **prawdą**; jest moją starannie przemyślaną Ten dokument nie jest obiektywną <strong>prawdą</strong>; jest moją
opinią, z informacjami i przykładami, które zebrałem. starannie przemyślaną opinią, z informacjami i przykładami, które zebrałem.
%p %p
To dlatego, że chcę, aby nasza społeczność osiągnęła konsensus. Wierzę, że To dlatego, że chcę, aby nasza społeczność osiągnęła konsensus. Wierzę, że
dyskusja jest tak samo istotna jak efekt końcowy. dyskusja jest tak samo istotna jak efekt końcowy.
%p %p
Więc proszę, <strong>#{link_to "zabieraj się za robotę", gh}</strong>. Więc proszę, <strong>#{link_to "wtrąć się", gh}</strong>.
.press .press
%h3 Rozmowy %h3 Rozmowy