Skip to content

Commit 9c58569

Browse files
p7novlenkis
andauthored
Apply suggestions from code review
Co-authored-by: Elena Shebunyaeva <[email protected]>
1 parent 1af7a6f commit 9c58569

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

doc/release/3.3.0.rst

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ Tarantool 3.3 brings a number of improvements around queries with offsets.
4343
provided offset size (``O(offset)``) or the number of tuples to count. Now,
4444
the new algorithm complexity is ``O(log(size))`` where ``size`` is the number of tuples
4545
in the index. This change also eliminates the dependency on the offset value or
46-
the number of tuple to count.
47-
- The :ref:`index <box_index>` and :ref:`space <box_space>` entities get the new
46+
the number of tuples to count.
47+
- The :ref:`index <box_index>` and :ref:`space <box_space>` entities get a new
4848
``offset_of`` method that returns the position relative to the given iterator
4949
direction of the tuple that matches the given key.
5050

@@ -73,7 +73,7 @@ back synchronous transactions on timeout (upon reaching :ref:`replication.synchr
7373
In the new implementation, transactions can only be rolled back by a new leader after it is elected.
7474
Otherwise, they can wait for a quorum infinitely.
7575

76-
Given that this changes the behavior, a new ``replication_synchro_timeout`` :ref:`compat <compat-module>` option is introduced.
76+
Given this change in behavior, a new ``replication_synchro_timeout`` :ref:`compat <compat-module>` option is introduced.
7777
To try the new behavior, set this option to ``new``:
7878

7979
- In YAML configuration:
@@ -91,23 +91,23 @@ To try the new behavior, set this option to ``new``:
9191
---
9292
...
9393
94-
There is also the new ``replication.synchro_queue_max_size`` configuration option
95-
that limits the total size of transactions in the master synchronous queue. By default,
96-
it's 16 megabytes.
94+
There is also a new ``replication.synchro_queue_max_size`` configuration option
95+
that limits the total size of transactions in the master synchronous queue. The default
96+
value is 16 megabytes.
9797

9898
.. _3-3-c-api-tx-thread:
9999

100100
C API for sending work to TX thread
101101
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
102102

103-
The new public C API functions ``tnt_tx_push()`` and ``tnt_tx_flush()``
103+
New public C API functions ``tnt_tx_push()`` and ``tnt_tx_flush()``
104104
allow to send work to the :ref:`TX thread <thread_model>` from any other thread:
105105

106106
- ``tnt_tx_push()`` schedules the given callback to be executed with the provided
107107
arguments.
108108

109-
- ``tnt_tx_flush()`` sends all the pending callback for execution in the TX thread.
110-
The execution is started in the same order as the callbacks were pushed.
109+
- ``tnt_tx_flush()`` sends all pending callbacks for execution in the TX thread.
110+
Execution is started in the same order as the callbacks were pushed.
111111

112112
.. _3-3-json-config-schema:
113113

@@ -131,7 +131,7 @@ As of Tarantool 3.3 release date, the following versions are available:
131131
Additionally, there is the `latest <https://download.tarantool.org/tarantool/schema/config.schema.json>`__
132132
schema that reflects the latest configuration schema in development (master branch).
133133

134-
Use these schemas to add completion for YAML configuration files and get
134+
Use these schemas to add code completion for YAML configuration files and get
135135
hints with option descriptions in your IDE, or validate your configurations,
136136
for example, with `check-jsonschema <https://pypi.org/project/check-jsonschema/>`__:
137137

@@ -153,7 +153,7 @@ broadcasted or the configuration is updated. The callback has three arguments:
153153

154154
- ``config`` -- the current configuration.
155155
- ``key`` -- an event that has triggered the callback: ``config.apply`` or ``box.status``.
156-
- ``value`` -- is the value of the ``box.status`` :ref:`system event <system-events>`.
156+
- ``value`` -- the value of the ``box.status`` :ref:`system event <system-events>`.
157157

158158
Example:
159159

@@ -194,7 +194,7 @@ alerts raised in all namespaces are shown in ``box.info.config.alerts``.
194194

195195
To raise an alert, use the namespace methods ``add()`` or ``set()``:
196196
The difference between them is that ``set()`` accepts a key to refer to the alert
197-
later: overwrite or discard it. An alert is a table with one mandatory field ``message``
197+
later: overwrite or discard it. An alert is a table with one mandatory field ``message``
198198
(its value is logged) and arbitrary used-defined fields.
199199

200200
.. code-block:: lua
@@ -241,7 +241,7 @@ Isolated instances
241241

242242
A new instance-level configuration option ``isolated`` puts an instance into the
243243
*isolated* mode. In this mode, an instance doesn't accept updates from other members
244-
of its replica set and other iproto requests. It also doesn't perform background
244+
of its replica set and other iproto requests. It also performs no background
245245
data modifications and remains in read-only mode.
246246

247247
.. code-block:: yaml
@@ -322,7 +322,7 @@ Tarantool 3.3 is receiving a number of supervised failover improvements:
322322
instance-002: -5
323323
instance-003: 4
324324
325-
Additionally, there is ``failover.learners`` section that lists instances
325+
Additionally, there is a ``failover.learners`` section that lists instances
326326
that should never be appointed as replica set leaders:
327327

328328
.. code-block:: yaml
@@ -358,8 +358,8 @@ two types of files: snapshots and write-ahead log (WAL) files. These files are a
358358
for replication: read-only replicas receive data changes from the replica set leader
359359
by reading these files.
360360

361-
The :ref:`garbage collector <configuration_persistence_garbage_collector>` that
362-
cleans up obsolete snapshots and WAL files it doesn't remove the files while they
361+
The :ref:`garbage collector <configuration_persistence_garbage_collector>`
362+
cleans up obsolete snapshots and WAL files, but it doesn't remove the files while they
363363
are in use for replication. To make such a check possible, the replica set leaders
364364
store the replication state in connection with files. However, this information
365365
was not persisted, which could lead to issues in case of the leader restart.
@@ -368,7 +368,7 @@ replicas that still read these files. The :ref:`wal.cleanup_delay <configuration
368368
configuration option was used to prevent such situations.
369369

370370
Since version 3.3, leader instances persist the information about WAL files in use
371-
in the new system space ``_gc_consumers``. After a restart, the replication state
371+
in a new system space ``_gc_consumers``. After a restart, the replication state
372372
is restored, and WAL files needed for replication are protected from garbage collection.
373373
This eliminates the need to keep all WAL files after a restart, so the ``wal.cleanup_delay``
374374
option is now deprecated.

0 commit comments

Comments
 (0)