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) #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

• [X] An Introduction to JavaScript (@jakubdrozdek) #17
• [X] Manuals and specifications (@jakubdrozdek) #20
• [X] Code editors (@bartek7, updated by @jakubdrozdek) #23
• [X] Developer console (@bartek7, updated by @jakubdrozdek ) #24

JavaScript Fundamentals

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

Code quality

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

Objects: the basics

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

Data types

• [X] Methods of primitives (@Fjollsfinn) #62
• [ ] Numbers (@TheTasak)
• [X] Strings (@RafalMichniuk) #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

• [X] Generators (@JanKesek) #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) #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

• [X] Fetch (@mitroc) #22
• [ ] FormData
• [X] Fetch: Download progress (@mitroc) #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

[random-passenger]

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.

[jakubdrozdek]

@bartek7 @JanKesek @Verthon @effhAVE Your PRs are still on the list, waiting for a review or merge. Are you willing to correct any mistakes and will you help with the further translation? Or can I copy/paste your translation and mark the article as translated by you (on the list in this issue). I'm asking because your PRs were created in your forked repos and I can't modify them in any way.

[jakubdrozdek]

@iliakan Thanks for the explanation. I've got a question: how am I supposed to mark any items on the list as done? I don't have the permission to edit it, and all of the checkboxes are disabled. Any ideas? In the React repo I had full access to the repo, so I could edit anything.

[iliakan]

@jakubdrozdek if a PR was created as a fork of this repo, you can pull the relevant branch and merge it locally, so there's no need to copy-paste.

Did you receive the github invite to join the org? If you did and joined, you have the access.

[jakubdrozdek]

You're right, it worked :-) I've just accepted the invitation.

[mitroc]

I'll take fetch.

[jakubdrozdek]

@iliakan Any plans on hosting the pl domain soon?

[iliakan]

@jakubdrozdek there's no point in opening pl in its current almost zero-translated state.

[mitroc]

@jakubdrozdek Can we use polish here or in reviews comments?