Polish Translation Progress

[iliakan]

Maintainer List

@deivuss331, @poplaw, @akowalska622, @Onxi95, @RafalMichniuk

For New Translators

Please read this first (click to open)

To translate an article:

1. Check that no one else has claimed your article in the checklist below.
2. Comment below with the title of the article that you would like to translate, exactly as listed, e.g. An Introduction to JavaScript.
   • Please take only one article at a time.
3. Fork this repo, translate the article in your fork and submit a pull request!
   • The pull request title should be same as the article, e.g. An Introduction to JavaScript (just like comment)

Please be prompt with your translations! If you find that you can't commit any more, let maintainers know so they can assign the page to someone else.

For Maintainers

Click to open

We recommend that a translation has 2 reviews to be merged.

Please let others know what you do, on community boards and chats, invite them to join. Translations become better if more people see them.

Translations are tracked below, like this:

• Home Page (@iliakan) Polish Translation Progress #1

Our helpful bot watches comments and adds the translator nick and PR id, marks completed, when PR is merged. You can read the details at https://javascript.info/translate/bot.

If something doesn't work right, please contact @iliakan.

Team translation

More details about team translation: https://javascript.info/translate/bot.

Only maintainers can check/uncheck items below. If you're not, please write in a comment what you take to translate, the title, exactly as in the list.

The JavaScript language

An introduction

• An Introduction to JavaScript (@jakubdrozdek) Intro #17
• Manuals and specifications (@jakubdrozdek) Translate 'Manuals and specifications' page #20
• Code editors (@bartek7, updated by @jakubdrozdek) Translate 'Code editors' page #23
• Developer console (@bartek7, updated by @jakubdrozdek ) Translate 'Dev tools' page #24

JavaScript Fundamentals

• Hello, world! (@jakubdrozdek) Translate 'Hello, world!' page #16
• Code structure (@bartek7, updated by @jakubdrozdek) Translate 'Code structure' page #21
• The modern mode, "use strict" (@bartek7, updated by @jakubdrozdek ) Translate 'Strict mode' page #25
• Variables (@effhAVE, updated by @jakubdrozdek) Translate 'Variables' page #28
• Data types (@Verthon, updated by @jakubdrozdek) Translate 'Data types' page #29
• Interaction: alert, prompt, confirm (@Verthon, updated by @jakubdrozdek) Translate 'Interaction: alert, prompt, confirm' page #35
• Type Conversions (@bartek7, updated by @jakubdrozdek) Translate 'Type conversions' page #30
• Basic operators, maths (@kkrawczykpl)
• Comparisons (@bartek7) Comparisons #14
• Conditional branching: if, '?' (@Fjollsfinn)
• Logical operators (@stnStanley)
• Nullish coalescing operator '??' (@sculpt0r) Nullish coalescing operator '??' #73
• Loops: while and for (@Moviss) Loops: while and for #75
• The "switch" statement (@Fjollsfinn)
• Functions (@dyrpit) Functions #85
• Function expressions (@kplich) Function expressions #93
• Arrow functions, the basics (@platypuswithoutk) Arrow functions, the basics #88
• JavaScript specials (@Onxi95) JavaScript specials #98

Code quality

• Debugging in the browser (@akowalska622)
• Coding Style (@ArturKot95)
• Comments (@sbielenica) Comments #26
• Ninja code (@jakubdrozdek)
• Automated testing with Mocha
• Polyfills and transpilers (@bartosztrusinski) Polyfills and transpilers #137

Objects: the basics

• Objects (@dwolanin)
• Object references and copying (@poplaw)
• Garbage collection (@RafalMichniuk)
• Object methods, "this" (@covalt1985) Object methods, "this" #99
• Constructor, operator "new"
• Optional chaining '?.' (@deivuss331) Optional chaining '?.' #103
• Symbol type
• Object to primitive conversion

Data types

• Methods of primitives (@Fjollsfinn) Methods of primitives #62
• Numbers (@TheTasak)
• Strings (@RafalMichniuk) Strings #133
• Arrays (@ostafinskim)
• Array methods
• Iterables (@suff42)
• Map and Set
• WeakMap and WeakSet
• Object.keys, values, entries
• Destructuring assignment
• Date and time
• JSON methods, toJSON

Advanced working with functions

• Recursion and stack
• Rest parameters and spread syntax
• Variable scope, closure
• The old "var"
• Global object
• Function object, NFE
• The "new Function" syntax
• Scheduling: setTimeout and setInterval
• Decorators and forwarding, call/apply
• Function binding
• Arrow functions revisited

Object properties configuration

• Property flags and descriptors
• Property getters and setters

Prototypes, inheritance

• Prototypal inheritance
• F.prototype
• Native prototypes
• Prototype methods, objects without proto

Classes

• Class basic syntax
• Class inheritance
• Static properties and methods
• Private and protected properties and methods
• Extending built-in classes
• Class checking: "instanceof"
• Mixins

Error handling

• Error handling, "try...catch" (@bartek7)
• Custom errors, extending Error (@bartek7)

Promises, async/await

• Introduction: callbacks
• Promise
• Promises chaining
• Error handling with promises
• Promise API
• Promisification
• Microtasks
• Async/await

Generators, advanced iteration

• Generators (@JanKesek) Generators #15
• Async iteration and generators

Modules

• Modules, introduction
• Export and Import
• Dynamic imports

Miscellaneous

• Proxy and Reflect
• Eval: run a code string
• Currying
• Reference Type
• BigInt
• Unicode, String internals
• WeakRef and FinalizationRegistry

Browser: Document, Events, Interfaces

Document

• Browser environment, specs (@riftmat) Browser environment, specs #136
• DOM tree
• Walking the DOM
• Searching: getElement*, querySelector*
• Node properties: type, tag and contents
• Attributes and properties
• Modifying the document
• Styles and classes
• Element size and scrolling
• Window sizes and scrolling
• Coordinates

Introduction to Events

• Introduction to browser events (@Katolus)
• Bubbling and capturing
• Event delegation
• Browser default actions
• Dispatching custom events

UI Events

• Mouse events
• Moving the mouse: mouseover/out, mouseenter/leave
• Drag'n'Drop with mouse events
• Pointer events
• Keyboard: keydown and keyup
• Scrolling

Forms, controls

• Form properties and methods
• Focusing: focus/blur
• Events: change, input, cut, copy, paste
• Forms: event and method submit

Document and resource loading

• Page: DOMContentLoaded, load, beforeunload, unload
• Scripts: async, defer
• Resource loading: onload and onerror

Miscellaneous

• Mutation observer
• Selection and Range
• Event loop: microtasks and macrotasks

Frames and windows

• Popups and window methods
• Cross-window communication
• The clickjacking attack

Binary data, files

• ArrayBuffer, binary arrays
• TextDecoder and TextEncoder
• Blob
• File and FileReader

Network requests

• Fetch (@mitroc) Fetch #22
• FormData
• Fetch: Download progress (@mitroc) Fetch: Download progress #31
• Fetch: Abort
• Fetch: Cross-Origin Requests
• Fetch API
• URL objects
• XMLHttpRequest
• Resumable file upload
• Long polling
• WebSocket
• Server Sent Events

Storing data in the browser

• Cookies, document.cookie
• LocalStorage, sessionStorage
• IndexedDB

Animation

• Bezier curve
• CSS-animations
• JavaScript animations

Web components

• From the orbital height
• Custom elements
• Shadow DOM
• Template element
• Shadow DOM slots, composition
• Shadow DOM styling
• Shadow DOM and events

Regular expressions

• Patterns and flags
• Character classes
• Unicode: flag "u" and class \p{...}
• Anchors: string start ^ and end $
• Multiline mode of anchors ^ $, flag "m"
• Word boundary: \b
• Escaping, special characters
• Sets and ranges [...]
• Quantifiers +, *, ? and {n}
• Greedy and lazy quantifiers
• Capturing groups
• Backreferences in pattern: \N and \k<name>
• Alternation (OR) |
• Lookahead and lookbehind
• Catastrophic backtracking
• Sticky flag "y", searching at position
• Methods of RegExp and String

[justdzasta]

I would like to translate the The modern mode, "use strict"

[aleksanderkrauze]

OK, go ahead @justdzasta

[Verthon]

I would like to translate the Data types

[JanKesek]

i can translate Document in Browser: Document, Events, Interfaces, starting with Browser environment, specs

[ghost]

I would like to translate Hello World!.

[effhAVE]

Variables

[Verthon]

Interaction: alert, prompt, confirm

[JanKesek]

Generators

[bartek7]

The next for me is Operators and Comparisions

[bartek7]

@iliakan @aleksanderkrauze Do you need more "Maintainers"? I can be one. And there are 9 pull requests. We should review pull requests more often.

[acrolisnun]

If no one has started on the Objects topic yet I can translate the first three subtopics : Objects, Garbage collection and Symbol type.

[bartek7]

@iliakan @aleksanderkrauze Can we create a Discord or something like that to communicate with each other?

[matwjablonski]

Hi, can I join to this project and help you? :)

[matwjablonski]

I will take Prototypes, inheritance :)

[Versoo]

Conditional operators: if, '?'

[mitroc]

Hi guys, is this project still alive? 11 PRs, some from July...
Do we have some Slack channel or something?

[iliakan]

@bartek7 @mitroc should I assign you as maintainers? Looks like the original maintainer @aleksanderkrauze isn't online any more.

[mitroc]

@iliakan Me, a maintainer? Sounds like a VIP :).
But seriously, thanks, but I'm not that good at JavaScript. I will gladly translate some simpler concepts, but I will not undertake to review those that I do not understand myself.

[iliakan]

The translation does not have maintainers now, as I see it.

[jakubdrozdek]

@iliakan Hello there! I'd like to help with translating the docs into Polish.
I'm the main maintainer of Polish translation repo for the official React docs (https://pl.reactjs.org). We've created a glossary there, so I guess I might help with jump-starting the translation process here. You may add me as a maintainer here if you like.
Cheers!

[iliakan]

@jakubdrozdek Hey, great to hear from you!

We really need a maintainer here. Added you, invite sent.

P.S. You might want to add the glossary link to the Readme.

[iliakan]

@jakubdrozdek We have a bot to ensure double-review of translations. When changes are requested, it adds a label, making PRs easier to filter.

The original bot idea was from react translate bot.

Until we have more reviewers, you can just merge instead of "approving changes". Still, if we get double reviews, that would make the translation quality better.

[poplaw]

@iliakan JS dev here, glad to review some PRs.

[deivuss331]

@iliakan yes, I can be a maintainer here.

[iliakan]

@deivuss331 @poplaw Welcome!

[ArturKot95]

I cant continue my work for now

…

On Thu, 14 Oct 2021 at 22:37, Ilya Kantor ***@***.***> wrote: @akowalska622 <https://github.com/akowalska622> @deivuss331 <https://github.com/deivuss331> @ostafinskim <https://github.com/ostafinskim> @covalt1985 <https://github.com/covalt1985> @Onxi95 <https://github.com/Onxi95> @ArturKot95 <https://github.com/ArturKot95> @poplaw <https://github.com/poplaw> @TheTasak <https://github.com/TheTasak> @dwolanin <https://github.com/dwolanin> @kplich <https://github.com/kplich> and others, please let me know if you have enough JS knowledge to review PRs and would like to get maintainership on the repo. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#1 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABMAHBWVOXMBW36WGE2TAC3UG45SHANCNFSM4H5EIYEA> .

[akowalska622]

I can try with pleasure!

[iliakan]

Thanks, @akowalska622, added you too for better progress! ;)

[Onxi95]

Are there still available slots for maintainers? I would like to help :) @iliakan

[iliakan]

Ok. Please review each other's PRs. Don't commit just because you can =)

[akowalska622]

Hey @iliakan, I wanted to review some PRs, but it seems like I can't do it for some reason :(
I mean there's no option in the interface to review, should I have some permissions?

[iliakan]

@akowalska622 did you accept the invite letter to join the team?

It must have been sent to your email 11 days ago (right when I added you).

[akowalska622]

@iliakan I must have missed it!
I found the mail with invitation, but unfortunately it expired after 7 days. Could you invite me again?
I'll check some PRs right away :D

[iliakan]

Try visiting https://github.com/javascript-tutorial/pl.javascript.info, do you see a notification with the invite above?
Or https://github.com/javascript-tutorial/pl.javascript.info/invitations.

P.S. If you don't please make a separate issue. As we talk not about translation progress, but rather about your access ;)

[suff42]

Iterables

[bartek7]

Error handling, "try...catch"

[bartek7]

Custom errors, extending Error

[riftmat]

Browser environment, specs

[khaaliee]

I would like to translate The old "var"

[ostafinskim]

Hi @iliakan
Due lack of time I need to drop my translate assignment of Array section. Cheers!

[bartosztrusinski]

Polyfills and transpilers