Skip to content

Commit 417c449

Browse files
committed
Add wording improvements to the docs
1 parent 5b9da9e commit 417c449

File tree

2 files changed

+9
-8
lines changed

2 files changed

+9
-8
lines changed

docs/providers/aggregate.rst

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Aggregate provider
1010
This page demonstrates how to implement the polymorphism and increase the
1111
flexibility of your application using the Aggregate provider.
1212

13-
:py:class:`Aggregate` provider aggregates other providers.
13+
:py:class:`Aggregate` provider aggregates a group of other providers.
1414

1515
.. currentmodule:: dependency_injector.providers
1616

@@ -20,7 +20,7 @@ Aggregate provider
2020
:emphasize-lines: 24-27
2121

2222
Each provider in the ``Aggregate`` is associated with a key. You can call aggregated providers by providing
23-
their key as a first argument. All positional and keyword arguments after the key will be forwarded to
23+
their key as a first argument. All positional and keyword arguments following the key will be forwarded to
2424
the called provider:
2525

2626
.. code-block:: python
@@ -33,7 +33,7 @@ You can also retrieve an aggregated provider by providing its key as an attribut
3333
3434
yaml_reader = container.config_readers.yaml("./config.yml", foo=...)
3535
36-
To retrieve a dictionary of aggregated providers with their associated keys, use ``.providers`` attribute:
36+
To retrieve a dictionary of aggregated providers, use ``.providers`` attribute:
3737

3838
.. code-block:: python
3939
@@ -46,7 +46,7 @@ To retrieve a dictionary of aggregated providers with their associated keys, use
4646
You can not override the ``Aggregate`` provider.
4747

4848
.. note::
49-
When you inject the ``Aggregate`` provider it is passed "as is".
49+
When you inject the ``Aggregate`` provider, it is passed "as is".
5050

5151
To use non-string keys or string keys with ``.`` and ``-``, provide a dictionary as a positional argument:
5252

@@ -59,13 +59,14 @@ To use non-string keys or string keys with ``.`` and ``-``, provide a dictionary
5959
})
6060
6161
.. seealso::
62-
:ref:`selector-provider` to inject selected provider based on a configuration value or other callable.
62+
:ref:`selector-provider` to make injections based on a configuration value, environment variable, or a result of a callable.
6363

6464
``Aggregate`` provider is different from the :ref:`selector-provider`. ``Aggregate`` provider doesn't select which provider
65-
to inject and doesn't have a selector. It is always injected "as is". The rest of the interface of both providers is similar.
65+
to inject and doesn't have a selector. It is a group of providers and is always injected "as is". The rest of the interface
66+
of both providers is similar.
6667

6768
.. note::
6869
``Aggregate`` provider is a successor of :ref:`factory-aggregate-provider` provider. ``Aggregate`` provider doesn't have
69-
a restriction on the provider type, while ``FactoryAggregate`` can aggregate only ``Factory`` providers.
70+
a restriction on the provider type, while ``FactoryAggregate`` aggregates only ``Factory`` providers.
7071

7172
.. disqus::

docs/providers/selector.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,6 @@ the provider with a matching name. The ``selector`` callable works as a switch:
3131
value is changed the ``Selector`` provider will delegate the work to another provider.
3232

3333
.. seealso::
34-
:ref:`aggregate-provider` to work with a group of providers.
34+
:ref:`aggregate-provider` to inject a group of providers.
3535

3636
.. disqus::

0 commit comments

Comments
 (0)