https://github.com/lightbend/kalix-jvm-sdk

Java and Scala SDKs for Kalix
https://github.com/lightbend/kalix-jvm-sdk

java scala serverless spring

Last synced: about 3 hours ago
JSON representation

Java and Scala SDKs for Kalix

• Host: GitHub
• URL: https://github.com/lightbend/kalix-jvm-sdk
• Owner: lightbend
• License: other
• Created: 2021-02-19T06:05:54.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-21T15:28:13.000Z (4 months ago)
• Last Synced: 2024-05-22T11:59:51.501Z (4 months ago)
• Topics: java, scala, serverless, spring
• Language: Scala
• Homepage: https://docs.kalix.io/java/index.html
• Size: 83.6 MB
• Stars: 55
• Watchers: 24
• Forks: 38
• Open Issues: 211
• Metadata Files:
  • Readme: README-vale.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Vale configuration

We use Vale https://github.com/errata-ai/vale a grammar, style and word usage linter for the English language.

## Configuration

### Configuration file

Vale's configuration is stored in the `.vale.ini` file located in the root directory.

### Styles

Our Vale [styles](https://docs.errata.ai/vale/styles) are stored in the [styles](styles) directory. These styles get packaged together and are enforced by the Vale CLI.

Words normally flagged by Vale that we wish to use anyway are stored in [styles/Vocab/Base/accept.txt](styles/Vocab/Base/accept.txt).

## Vale in CI using GitHub Actions

We run Vale in CI using the open source [GitHub Action](https://github.com/marketplace/actions/vale-linter). Configuration is stored in `.github/workflows/linting.yml`. The `MinAlertLevel` set in `.vale.ini` determines the alert level at which the GitHub Action will fail a build.

## Running locally

To run Vale locally:

macOS

```bash

gem install asciidoctor

brew install vale

vale docs

```

When writing new sections of documentation, we recommend running Vale to see linting alerts at `warning` or `suggestion` level. The alerts might provide suggestions on how to make your writing:

- clear: simple words

- concise: sentences < 30 words

- free of jargon

- free of spelling and grammatical errors

- free of accidental offensive language.

To do this:

macOS

```bash

vale --minAlertLevel warning docs

```

macOS

```bash

vale --minAlertLevel suggestion docs

```