Sharding reference

[andreyaksenov]

• Added the sharding section to a new config reference. Staging: sharding.
• Added missing options to the legacy config reference and marked some options as deprecated. Staging: Basic parameters.
• Added links to sched_ref_quota and sched_move_quota options in the vshard.router.map_callrw description.
• Added links to sharding.bucket_count and sharding.roles options in the Creating a sharded cluster tutorial:
  • https://docs.d.tarantool.io/en/doc/sharding-reference/how-to/vshard_quick/#step-3-configuring-bucket-count
  • https://docs.d.tarantool.io/en/doc/sharding-reference/how-to/vshard_quick/#step-4-defining-the-cluster-topology

[Serpentian]

I'm ok with the current version, but AFAICS it's still WIP. I'll take another look, when rebalancer_mode is added. Though, I'm not quite sure, we should add connection_outdate_delay as it was undocumented for 6 years.

Just an idea:

doc/doc/reference/configuration/configuration_reference.rst

Lines 151 to 154 in fe9585d

	.. note::
	The option only has an effect if the :ref:`audit_log.to <configuration_reference_audit_to>` is set to ``syslog``
	or ``pipe``.

For some options we specify, when it works. Don't we want to say, whether the option applies to storage or router in notes?

[andreyaksenov]

Just an idea:

doc/doc/reference/configuration/configuration_reference.rst

Lines 151 to 154 in fe9585d

	.. note::
	The option only has an effect if the :ref:`audit_log.to <configuration_reference_audit_to>` is set to ``syslog``
	or ``pipe``.

For some options we specify, when it works. Don't we want to say, whether the option applies to storage or router in notes?

Good point. Where applicable, I added links to corresponding sections in the topics related to vshard concepts and architecture (such as Rebalancing, Replica weights, and so on). Looks that this should be enough for now. When missing options are implemented in a new config (v3.1, I guess), I plan to rework the whole docs related to sharding and make one more round on updating this reference to make it more consistent.

[xuniq]

The link here might be useful:
https://docs.d.tarantool.io/en/doc/sharding-reference/concepts/sharding/#sharding

[andreyaksenov]

Added a link to https://docs.d.tarantool.io/en/doc/sharding-reference/book/admin/vshard_admin/ - I think, this will be the main topic related to sharding configuration when v3.1 is released.