Skip to content
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

Add Vale config #3585

Merged
merged 1 commit into from
Jul 21, 2023
Merged

Add Vale config #3585

merged 1 commit into from
Jul 21, 2023

Conversation

andreyaksenov
Copy link
Contributor

@andreyaksenov andreyaksenov commented Jul 17, 2023

Added the Vale configuration to the documentation. This configuration includes two predefined packages that implement Microsoft and Google style guides:

Moreover, this PR includes a custom Tarantool style, which includes several rules from the GitLab config.

Apart from three styles, the styles/Vocab/Tarantool/accept.txt file contains valid Tarantool-specific terms.

To show Vale warnings in the PyCharm editor, follow the steps below (macOS):

  1. Install Vale: brew install vale.
  2. Install Sphinx for RST support: brew install sphinx-doc.
  3. Make sure that the Grazie Professional plugin is installed and enabled.
  4. On the Preferences | Editor | Natural Languages | Grazie Professional page, turn on the Enable Vale annotations option.
  5. In the repository folder, execute the vale sync command.

PyCharm should now use the Vale config automatically (.vale.ini) and show warnings right in the editor:
image

Please add your suggestions regarding customizing Microsoft/Google styles or adding Tarantool-specific rules and terms.

TODO:

  • Add information about Vale configuration to README.

Copy link
Contributor

@p7nov p7nov left a comment

Choose a reason for hiding this comment

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

Great 👍
I've added some points I've spotted when checking the rules on random doc pages.

Anyway, we can push this config and adapt it further later.

Copy link
Contributor

Choose a reason for hiding this comment

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

Already added in Foreign.yml

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe join with Terms.yml?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Moved Terms.yml words to WordList.yml.

sharded
nullable
coroutines
multikey
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
multikey
multikey
datetime
varbinary

Android device: Android-powered device
android: Android
API explorer: APIs Explorer
application: app
Copy link
Contributor

Choose a reason for hiding this comment

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

Not sure this is valid for our case.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

agree, forgot to remove

methodology: method
modify: change
monitor: check|watch
multiple: many
Copy link
Contributor

Choose a reason for hiding this comment

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

'multiple' seems fine to me.

consequently: so
consolidate: merge
constitutes: forms
contains: has
Copy link
Contributor

Choose a reason for hiding this comment

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

'contains' seems fine to me.

cellular network: mobile network
chapter: documents|pages|sections
check box: checkbox
check: select
Copy link
Contributor

Choose a reason for hiding this comment

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

Not our case, I think.

level: warning
ignorecase: true
tokens:
- currently
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
- currently
- currently
- previously
- now
- today
- in(?: the|) future

@andreyaksenov andreyaksenov force-pushed the vale-config branch 4 times, most recently from aa17361 to 27b0e74 Compare July 21, 2023 11:44
@andreyaksenov andreyaksenov merged commit 9f423c5 into latest Jul 21, 2023
1 check passed
@andreyaksenov andreyaksenov deleted the vale-config branch July 21, 2023 12:07
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.

Add a Vale configuration to Tarantool docs
3 participants