@@ -18,7 +18,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
 [![core 100.00%](https://img.shields.io/badge/core-100.00%25-0.svg)](https://translations.python.org/#pl)
 [![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.70%25-0.svg)](https://translations.python.org/#pl)
-[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.34%25-0.svg)](https://translations.python.org/#pl)
+[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.33%25-0.svg)](https://translations.python.org/#pl)
 [![lint errors count](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=lint%20errors)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
 
 <!-- [[[end]]] -->
 
@@ -18,7 +18,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
 [![podstawowe artykuły 100.00%](https://img.shields.io/badge/podstawowe_artykuły-100.00%25-0.svg)](https://translations.python.org/#pl)
 [![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.70%25-0.svg)](https://translations.python.org/#pl)
-[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.34%25-0.svg)](https://translations.python.org/#pl)
+[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.33%25-0.svg)](https://translations.python.org/#pl)
 [![liczba błędów lintowania](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=b%C5%82%C4%99dy%20lintowania)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
 
 <!-- [[[end]]] -->
 
@@ -5,17 +5,17 @@
 #
 # Translators:
 # python-doc bot, 2026
-# Rafael Fontenelle <rffontenelle@gmail.com>, 2026
 # Maciej Olko, 2026
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2026
 #
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-10-03 17:41+0000\n"
+"POT-Creation-Date: 2026-10-13 19:59+0000\n"
 "PO-Revision-Date: 2026-09-13 17:09+0000\n"
-"Last-Translator: Maciej Olko, 2026\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2026\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -1071,7 +1071,7 @@ msgid ""
 "using :func:`int` instead."
 msgstr ""
 
-msgid "Iterator Types"
+msgid "Iteration-related types"
 msgstr ""
 
 msgid ""
@@ -1081,6 +1081,9 @@ msgid ""
 "support the iteration methods."
 msgstr ""
 
+msgid "Iterables"
+msgstr ""
+
 msgid ""
 "One method needs to be defined for container objects to provide :term:"
 "`iterable` support:"
@@ -1097,6 +1100,9 @@ msgid ""
 "in the Python/C API."
 msgstr ""
 
+msgid "Iterators"
+msgstr "Iteratory"
+
 msgid ""
 "The iterator objects themselves are required to support the following two "
 "methods, which together form the :dfn:`iterator protocol`:"
@@ -1129,17 +1135,298 @@ msgid ""
 "Implementations that do not obey this property are deemed broken."
 msgstr ""
 
-msgid "Generator Types"
+msgid "Generator types"
+msgstr ""
+
+msgid ""
+"Python's :term:`generators <generator>` -- or more precisely, :term:"
+"`generator functions <generator function>` and :term:`generator iterators "
+"<generator iterator>` -- provide a convenient way to implement the iterator "
+"protocol."
+msgstr ""
+
+msgid ""
+"A function that contains one or more :ref:`yield expressions <yieldexpr>` is "
+"a :term:`generator function`. For example::"
+msgstr ""
+
+msgid ""
+">>> def count_to_three():\n"
+"...     yield 0\n"
+"...     yield 1\n"
+"...     yield 2\n"
+"...     yield 3"
+msgstr ""
+
+msgid ""
+"Generator functions behave as regular :ref:`user-defined functions <user-"
+"defined-funcs>` (for example, they have the same attributes), except that "
+"calling a generator function returns a :ref:`generator iterator <generator-"
+"methods>`::"
+msgstr ""
+
+msgid ""
+">>> count_to_three()\n"
+"<generator object count_to_three at 0x7f33a2305000>"
+msgstr ""
+
+msgid ""
+"Iterating a generator iterator executes code of the underlying generator "
+"function, producing each :keyword:`yield`\\ed value in turn::"
+msgstr ""
+
+msgid ""
+">>> for number in count_to_three():\n"
+"...     print(number)\n"
+"0\n"
+"1\n"
+"2\n"
+"3\n"
+"\n"
+">>> list(count_to_three())\n"
+"[0, 1, 2, 3]"
+msgstr ""
+
+msgid ""
+"One common use for generator functions is implementing the :meth:`~object."
+"__iter__` method of custom iterable objects. For example::"
+msgstr ""
+
+msgid ""
+">>> class CardDeck:\n"
+"...     def __iter__(self):\n"
+"...         yield 'three of clubs'\n"
+"...         yield 'ace of hearts'\n"
+"\n"
+">>> list(CardDeck())\n"
+"['three of clubs', 'ace of hearts']"
+msgstr ""
+
+msgid "Generator iterators"
+msgstr ""
+
+msgid ""
+"Generator iterators implement the :ref:`iterator protocol <stdtypes-"
+"iterators>`. Iterating them drives execution of the underlying generator "
+"function."
+msgstr ""
+
+msgid ""
+"Starts the execution of a generator function or resumes it at the :ref:"
+"`yield expression <yieldexpr>` where the function is currently suspended. "
+"When a generator function is resumed with a :meth:`~generator.__next__` "
+"method, the current yield expression always evaluates to :const:`None`. The "
+"execution then continues to the next yield expression, where the generator "
+"is suspended again, and the value of the expression after the :keyword:"
+"`yield` keyword is returned to :meth:`~generator.__next__`'s caller. If the "
+"generator exits without yielding another value, :meth:`~generator.__next__` "
+"raises a :exc:`StopIteration` exception, signalling that iteration has "
+"completed."
+msgstr ""
+
+msgid ""
+"This method is normally called implicitly, for example by a :keyword:`for` "
+"loop, or by the built-in :func:`next` function."
+msgstr ""
+
+msgid ""
+"Generator iterators have a few more methods than generic iterators, which "
+"can be used to control the execution of the underlying generator function:"
+msgstr ""
+
+msgid ""
+"\"Sends\" a value into the generator function: the *value* argument becomes "
+"the result of the current yield expression."
+msgstr ""
+
+msgid ""
+"Otherwise, this method behaves like :meth:`~generator.__next__`: it resumes "
+"the underlying function and either returns the next yielded value or raises :"
+"exc:`StopIteration`."
+msgstr ""
+
+msgid ""
+"When :meth:`send` is called to start the generator, it must be called with :"
+"const:`None` as the argument, because there is no current yield expression "
+"that could receive the value."
+msgstr ""
+
+msgid ""
+"Raises an exception at the point where the generator is currently suspended."
+msgstr ""
+
+msgid ""
+"Otherwise, this method behaves like :meth:`~generator.__next__`: it resumes "
+"the underlying function and either returns the next yielded value or raises :"
+"exc:`StopIteration`. If the generator function does not catch the passed-in "
+"exception, or raises a different exception, then that exception propagates "
+"to the caller."
+msgstr ""
+
+msgid ""
+"When :meth:`throw` is called to start the generator, the generator "
+"immediately exits (that is, subsequent calls to :meth:`~generator.__next__` "
+"will raise :exc:`StopIteration`) and the thrown exception is propagated to :"
+"meth:`throw`'s caller."
+msgstr ""
+
+msgid ""
+"In typical use, this is called with a single argument, an exception "
+"instance, similar to the way the :keyword:`raise` keyword is used."
+msgstr ""
+
+msgid ""
+"For backwards compatibility, however, the second signature is supported, "
+"following a convention from older versions of Python. The *type* argument "
+"should be an exception class, and *value* should be an exception instance. "
+"If the *value* is not provided, the *type* constructor is called to get an "
+"instance. If *traceback* is provided, it is set on the exception, otherwise "
+"any existing :attr:`~BaseException.__traceback__` attribute stored in "
+"*value* may be cleared."
+msgstr ""
+
+msgid ""
+"The second signature \\(type\\[, value\\[, traceback\\]\\]\\) is deprecated "
+"and may be removed in a future version of Python."
+msgstr ""
+
+msgid ""
+"Raises a :exc:`GeneratorExit` exception at the point where the generator "
+"function is currently suspended (equivalent to calling "
+"``throw(GeneratorExit)``)."
+msgstr ""
+
+msgid ""
+"If the generator function has already exited (due to an exception or normal "
+"return), or raises :exc:`GeneratorExit` (by not catching the exception), :"
+"meth:`close` returns :const:`None`. If the generator yields a value, a :exc:"
+"`RuntimeError` is raised. If the generator raises any other exception, it is "
+"propagated to the caller. If a generator returns a value upon being closed, "
+"that value is returned by :meth:`close`."
+msgstr ""
+
+msgid ""
+"When a generator iterator is garbage collected before it has exited, :meth:"
+"`~generator.close` is called automatically."
+msgstr ""
+
+msgid ""
+"If a generator returns a value upon being closed, the value is returned by :"
+"meth:`close`. Previously, it returned ``None``."
+msgstr ""
+
+msgid ""
+"Calling any of the generator methods (:meth:`~generator.__next__`, :meth:"
+"`~generator.send`, :meth:`~generator.throw`, :meth:`~generator.close`) while "
+"one of these methods is already executing raises a :exc:`ValueError` "
+"exception."
+msgstr ""
+
+msgid "Asynchronous generator iterators"
+msgstr ""
+
+msgid ""
+"This subsection describes the methods of an asynchronous generator iterator, "
+"which are used to control the execution of an asynchronous generator "
+"function."
 msgstr ""
 
 msgid ""
-"Python's :term:`generator`\\s provide a convenient way to implement the "
-"iterator protocol.  If a container object's :meth:`~object.__iter__` method "
-"is implemented as a generator, it will automatically return an iterator "
-"object (technically, a generator object) supplying the :meth:`~iterator."
-"__iter__` and :meth:`~generator.__next__` methods. More information about "
-"generators can be found in :ref:`the documentation for the yield expression "
-"<yieldexpr>`."
+"Returns an :term:`awaitable` which when run starts to execute the "
+"asynchronous generator function or resumes it at the :ref:`yield expression "
+"<yieldexpr>` where the function is currently suspended. When an asynchronous "
+"generator function is resumed with an :meth:`~agen.__anext__` method, the "
+"current yield expression always evaluates to :const:`None` in the returned "
+"awaitable, which when run will continue to the next yield expression. The "
+"value of the expression after the :keyword:`yield` keyword is the value of "
+"the :exc:`StopIteration` exception raised by the completing coroutine. If "
+"the asynchronous generator exits without yielding another value, the "
+"awaitable instead raises a :exc:`StopAsyncIteration` exception, signalling "
+"that the asynchronous iteration has completed."
+msgstr ""
+
+msgid ""
+"This method is normally called implicitly by an :keyword:`async for` loop, "
+"or by the built-in :func:`anext` function."
+msgstr ""
+
+msgid ""
+"Asynchronous generator-iterators have a few more methods than generic "
+"asynchronous iterators, which can be used to control the execution of the "
+"underlying generator function:"
+msgstr ""
+
+msgid ""
+"Returns an awaitable which, when run, \"sends\" a value into the underlying "
+"asynchronous generator function: the *value* argument becomes the result of "
+"the current yield expression."
+msgstr ""
+
+msgid ""
+"Otherwise, this method behaves like :meth:`~agen.__anext__`: when the "
+"returned awaitable runs, it resumes the underlying function and either "
+"returns the next yielded value as the value of the raised :exc:"
+"`StopIteration`, or raises :exc:`StopAsyncIteration`."
+msgstr ""
+
+msgid ""
+"When :meth:`asend` is called to start the asynchronous generator, it must be "
+"called with :const:`None` as the argument, because there is no yield "
+"expression that could receive the value."
+msgstr ""
+
+msgid ""
+"Returns an awaitable that, when run, raises an exception at the point where "
+"the underlying asynchronous generator function is currently suspended."
+msgstr ""
+
+msgid ""
+"Otherwise, this method behaves like :meth:`~agen.__anext__`: when the "
+"returned awaitable runs, it resumes the underlying function (with an "
+"exception raised) and either returns the next yielded value as the value of "
+"the raised :exc:`StopIteration`, or raises :exc:`StopAsyncIteration`. If the "
+"underlying function does not catch the passed-in exception, or raises a "
+"different exception, then when the awaitable is run, that exception "
+"propagates to the caller of the awaitable."
+msgstr ""
+
+msgid ""
+"When :meth:`~agen.athrow` is called to start the generator, the generator "
+"exits when the awaitable runs (that is, subsequent results from :meth:`~agen."
+"__anext__` will raise :exc:`StopAsyncIteration` when run) and the thrown "
+"exception is propagated to the awaitable's caller."
+msgstr ""
+
+msgid ""
+"For backwards compatibility, however, the second signature is supported. An "
+"exception instance is created from three arguments in the same way as in :"
+"meth:`generator.throw`."
+msgstr ""
+
+msgid ""
+"Returns an awaitable that when run will throw a :exc:`GeneratorExit` into "
+"the underlying asynchronous generator function at the point where it is "
+"currently suspended (equivalent to calling ``athrow(GeneratorExit)``)."
+msgstr ""
+
+msgid ""
+"If the asynchronous generator function then exits gracefully, is already "
+"closed, or raises :exc:`GeneratorExit` (by not catching the exception), then "
+"the returned awaitable will raise a :exc:`StopIteration` exception. Any "
+"further awaitables returned by subsequent calls to the asynchronous "
+"generator will raise a :exc:`StopAsyncIteration` exception."
+msgstr ""
+
+msgid ""
+"If the asynchronous generator yields a value, a :exc:`RuntimeError` is "
+"raised by the awaitable. If the asynchronous generator raises any other "
+"exception, that exception is propagated to the caller of the awaitable."
+msgstr ""
+
+msgid ""
+"If the asynchronous generator has already exited due to an exception or "
+"normal exit, then further calls to :meth:`aclose` will return an awaitable "
+"that does nothing."
 msgstr ""
 
 msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`"
@@ -7788,6 +8075,24 @@ msgstr ""
 msgid "iteration over"
 msgstr ""
 
+msgid "generator"
+msgstr "generator"
+
+msgid "exception"
+msgstr ""
+
+msgid "StopIteration"
+msgstr ""
+
+msgid "GeneratorExit"
+msgstr ""
+
+msgid "asynchronous-generator"
+msgstr ""
+
+msgid "StopAsyncIteration"
+msgstr ""
+
 msgid "len"
 msgstr "len"