Skip to content

Add an explicit requirement to capitalize Tarantool #2800

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 1 commit into from
Apr 11, 2022

Conversation

patiencedaur
Copy link
Contributor

We have a "Writing about code" section, but the user may not be sure when to consult it. This is an important product-related requirement, so I decided to make it explicit and provide a link to the section.

@github-actions github-actions bot temporarily deployed to branch-tarantool-capitalization-guideline April 11, 2022 05:50 Inactive
~~~~~~~~~~~~~~~~~~~~~~~~

The word "Tarantool" is capitalized because it's a product name.
The only context where it can start with a lowercase "t" is code.
Copy link
Member

Choose a reason for hiding this comment

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

Technically it makes legal to use the lowercased variant in a comment in the code. I would say, when a shell commmand / executable assumed.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If the comment becomes part of the documentation (say, via ldoc), then this rule is applied. Comments that don't end up in the documentation are covered by the code style guide, not by this guide.

@patiencedaur patiencedaur merged commit 0ca432a into latest Apr 11, 2022
@patiencedaur patiencedaur deleted the tarantool-capitalization-guideline branch April 11, 2022 12:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants