Skip to content

Update docs for the 'box.info' module #4427

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Aug 15, 2024
Merged

Update docs for the 'box.info' module #4427

merged 5 commits into from
Aug 15, 2024

Conversation

andreyaksenov
Copy link
Contributor

@andreyaksenov andreyaksenov commented Aug 12, 2024

This PR updates the box.info documentation to make its quality a bit better:

  • All functions/fields exposed by box.info now have their own pages.
  • The index page and the table of contents are consistent now and list all module members in alphabetical order.
  • All the descriptions look more consistent now.

PR also includes updates introduced in v3.0.0 and later, for example, box.info.config, box.info.hostname. See the staging here: https://docs.d.tarantool.io/en/doc/update-box-info/reference/reference_lua/box_info/

Also some new box.cfg options are documented (instance_name, replicaset_name, cluster_name): https://docs.d.tarantool.io/en/doc/update-box-info/reference/configuration/#replication

UPD: Specified the rules applied to names in the Configuration reference:
https://docs.d.tarantool.io/en/doc/update-box-info/reference/configuration/configuration_reference/#groups
They are the same as for new box.cfg options.

@andreyaksenov andreyaksenov marked this pull request as ready for review August 13, 2024 13:46
@andreyaksenov andreyaksenov changed the title Update box.info() Update docs for the 'box.info' module Aug 13, 2024
@xuniq xuniq self-requested a review August 14, 2024 08:32

.. data:: package

The package name.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: We can say something like the following:

Currently there are Tarantool and Tarantool Enterprise packages.

This way it is less abstract and a developer knows that it allows to distinguish CE/EE editions.


The package name.

See also: :ref:`tarantool --version <index-tarantool_version>`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also reported from tarantool.package.


The Tarantool version.

See also: :ref:`tarantool --version <index-tarantool_version>`
Copy link
Member

@Totktonada Totktonada Aug 14, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also reported from tarantool.version. See https://stackoverflow.com/a/65330537/1598057.

Copy link
Member

@Totktonada Totktonada left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! I've no objections.

- The instance's state in regard to configuration

* - :doc:`./box_info/election`
- The current state of this replica set node in regards to leader election
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The current state of this replica set node in regards to leader election
- The current state of this replica set node in regard to leader election


Show the current state of a replica set node in regards to :ref:`leader election <repl_leader_elect>`.
The current state of this replica set node in regards to :ref:`leader election <repl_leader_elect>`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The current state of this replica set node in regards to :ref:`leader election <repl_leader_elect>`.
The current state of this replica set node in regard to :ref:`leader election <repl_leader_elect>`.

@andreyaksenov andreyaksenov merged commit 9e57f6c into latest Aug 15, 2024
1 check failed
@andreyaksenov andreyaksenov deleted the update-box-info branch August 15, 2024 13:23
p7nov added a commit that referenced this pull request Oct 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants